# 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.

- Skill: `diegosouzapw/mcp-development` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/mcp-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/mcp-development/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/mcp-development

---


# 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
```