# MCP Development

> Complete MCP development toolkit for creating, debugging, testing, and reviewing MCP servers. Use when setting up new MCP projects, creating tools, debugging connection issues, reviewing MCP code, or generating documentation. Use when this capability is needed.

- Skill: `tomevault-io/mcp-development-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/mcp-development-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mcp-development-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/mcp-development-3

---


# MCP Development Toolkit

Complete toolkit for MCP server development including project setup, tool creation, debugging, and code review.

## Project Setup

### Directory Structure
```
mcp-project/
├── src/
│   ├── index.ts          # Server entry point
│   ├── tools/            # Tool definitions
│   │   └── index.ts
│   ├── db/               # Database connections
│   │   └── connection.ts
│   └── utils/
│       └── index.ts
├── build/                # Compiled output
├── .env.example
├── package.json
├── tsconfig.json
└── README.md
```

### package.json
```json
{
  "name": "mcp-server",
  "version": "1.0.0",
  "type": "module",
  "main": "build/index.js",
  "scripts": {
    "build": "tsc",
    "start": "node build/index.js",
    "dev": "tsc --watch",
    "inspector": "npx @modelcontextprotocol/inspector"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "zod": "^3.23.0"
  },
  "devDependencies": {
    "@types/node": "^20.0.0",
    "typescript": "^5.0.0"
  }
}
```

### tsconfig.json
```json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "outDir": "build",
    "rootDir": "src",
    "declaration": true,
    "sourceMap": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "build"]
}
```

For detailed setup guide, see [SETUP.md](SETUP.md).

## Creating Tools

For tool creation templates and patterns, see [TOOLS.md](TOOLS.md).

## Debugging

For common issues and debugging techniques, see [DEBUG.md](DEBUG.md).

## Code Review

For review checklists, see [REVIEW.md](REVIEW.md).

## Quick Commands

```bash
# Initialize project
npm init -y && npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node && npx tsc --init

# Build and run
npm run build && node build/index.js

# Test with inspector
npx @modelcontextprotocol/inspector
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/fabriciofs) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->