create-mcp-server

One command to create a production-ready MCP Server ⚡

MCP (Model Context Protocol) is the standard for connecting AI assistants like Claude to external tools and data sources. This package provides:

1. CLI - Scaffold a complete MCP Server project in seconds
2. SDK - Ergonomic TypeScript API for building servers

Quick Start

# Create a new MCP server project
npx create-mcp-server my-server

# Or start from an example
npx create-mcp-server my-server --example calculator

cd my-server
npm install
npm run dev

That's it! You now have a working MCP Server with:

• ✅ TypeScript setup
• ✅ Tool, resource, and prompt examples
• ✅ Build configuration
• ✅ Claude Desktop integration guide

CLI Usage

npx create-mcp-server <project-name> [options]

Options:
  --example <name>    Start with an example (calculator, filesystem, weather, github, database)
  -h, --help          Show help
  -v, --version       Show version

Examples

| Example | Description | |---------|-------------| | calculator | Math operations (add, subtract, multiply, divide, power, sqrt) | | filesystem | File operations (read, write, list, info, create, delete) | | weather | Weather data via wttr.in (current, forecast) | | github | GitHub API (repo info, issues, user data) | | database | Database operations (query, insert, create table) |

SDK Usage

The generated project uses @modelcontextprotocol/sdk directly. Here's the pattern:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({
  name: "my-server",
  version: "1.0.0",
});

// Register a tool
server.tool(
  "greet",
  "Greet someone by name",
  { name: z.string().describe("Name to greet") },
  async ({ name }) => ({
    content: [{ type: "text", text: `Hello, ${name}!` }],
  })
);

// Register a resource
server.resource(
  "config",
  "config://app",
  { description: "Application config" },
  async (uri) => ({
    contents: [{ uri: uri.href, text: JSON.stringify({ version: "1.0.0" }) }],
  })
);

// Register a prompt
server.prompt(
  "help",
  { description: "Get help" },
  async () => ({
    messages: [{ role: "user", content: { type: "text", text: "How can I help?" } }],
  })
);

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Using with Claude Desktop

Add your server to Claude Desktop's config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-server/dist/index.js"]
    }
  }
}

Restart Claude Desktop and your tools will be available!

Project Structure

my-server/
├── src/
│   └── index.ts      # Server entry point
├── dist/             # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

API Reference

Tools

Tools let AI models invoke actions on your server:

server.tool(
  "tool-name",           // Unique identifier
  "Description",         // Human-readable description
  {                      // Input schema (Zod)
    param: z.string(),
  },
  async (args) => {      // Handler
    return {
      content: [{ type: "text", text: "result" }],
    };
  }
);

Resources

Resources expose read-only data:

server.resource(
  "resource-name",
  "resource://uri",      // URI pattern
  { description: "..." },
  async (uri) => ({
    contents: [{ uri: uri.href, text: "data" }],
  })
);

Prompts

Prompts are reusable templates:

server.prompt(
  "prompt-name",
  { description: "..." },
  async () => ({
    messages: [
      { role: "user", content: { type: "text", text: "..." } },
    ],
  })
);

Why create-mcp-server?

• Zero config - Works out of the box
• Type-safe - Full TypeScript support with Zod schemas
• Production-ready - Proper build setup, error handling, docs
• Examples - Real-world examples to learn from
• Minimal deps - Only @modelcontextprotocol/sdk and zod

Comparison

| Feature | create-mcp-server | Manual Setup | |---------|-------------------|--------------| | Time to first tool | ~30 seconds | ~30 minutes | | TypeScript config | ✅ Included | Manual | | Build setup | ✅ Included | Manual | | Examples | ✅ 5 examples | None | | Claude Desktop guide | ✅ Included | Find yourself |

Contributing

Contributions welcome! See GitHub.

License

MIT © Mike Wang

Links

• MCP Documentation
• MCP TypeScript SDK
• Example MCP Servers