create-mcp-express

Quickly scaffold a new Model Context Protocol (MCP) server with Express.js.

Usage

# With npx (recommended)
npx create-mcp-express my-mcp-server

# With npm
npm create mcp-express my-mcp-server

# With yarn
yarn create mcp-express my-mcp-server

# With pnpm
pnpm create mcp-express my-mcp-server

What's Included

This scaffolding tool creates a fully functional MCP server with:

• ✅ Express.js HTTP server with MCP protocol support
• ✅ TypeScript with strict mode enabled
• ✅ Jest testing framework with coverage reports
• ✅ Modular architecture for tools, resources, and prompts
• ✅ Built-in examples (math tools, greeting resources)
• ✅ Health check endpoint
• ✅ Logging utilities
• ✅ MCP Inspector integration for debugging

Quick Start

After creating your project:

cd my-mcp-server
npm install
npm run dev        # Start development server
npm test           # Run tests
npm run inspect    # Start with MCP Inspector

Project Structure

my-mcp-server/
├── src/
│   ├── server/          # HTTP and MCP server implementations
│   ├── tools/           # MCP tools (extensible)
│   ├── resources/       # MCP resources (extensible)
│   ├── registry/        # Central registry for tools/resources
│   ├── utils/           # Utility functions
│   └── __tests__/       # Test files
├── package.json
└── tsconfig.json

Adding New Tools

1. Create a new file in src/tools/your-tool/
2. Implement your tool following the MCP specification
3. Register it in src/registry/index.ts

Adding New Resources

1. Create a new file in src/resources/your-resource/
2. Implement your resource following the MCP specification
3. Register it in src/registry/index.ts

Documentation

See the generated README.md in your project for more details.

License

MIT