MCP Server Starter Kit

A minimal Model Context Protocol server starter in TypeScript. Build custom AI tools in minutes.

MCP lets AI assistants like Claude and Cursor call your code — database queries, API calls, file operations, anything you can write a function for. This starter gives you a working server with everything wired up so you can skip the boilerplate and start building.

Quick Start

git clone https://github.com/tysoncung/mcp-server-starter.git
cd mcp-server-starter
npm install

Run in development mode (hot reload):

npm run dev

That's it. Your MCP server is running.

What's Inside

A single example tool (echo) that demonstrates the pattern for defining MCP tools:

server.tool(
  'echo',                                           // Tool name
  'Echo back the provided message',                 // Description for the AI
  { message: z.string().describe('Message text') }, // Input schema (Zod)
  async ({ message }) => {                          // Handler
    return { content: [{ type: 'text', text: `Echo: ${message}` }] };
  },
);

To add your own tools, follow the same pattern in src/server.ts. Define a name, describe what it does, declare the inputs with Zod, and write the handler.

Add to Claude Desktop

Build the project first:

npm run build

Edit your Claude Desktop config file:

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

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

Restart Claude Desktop and your tools will be available.

Add to Cursor

Open Cursor Settings → MCP → Add Server, or edit .cursor/mcp.json in your project:

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

Scripts

Command	Description
npm run dev	Start with hot reload (tsx watch)
npm run build	Compile TypeScript to dist/
npm start	Run compiled output
npm test	Run tests

Project Structure

src/
├── server.ts              # Server setup & tool definitions
├── index.ts               # Entry point (stdio transport)
└── __tests__/
    └── server.test.ts     # Tool tests

Requirements

• Node.js ≥ 20
• npm

---

Want More? 🚀

This free starter gets you up and running with one example tool and stdio transport. The Pro Starter Kit gives you everything you need to ship production MCP servers:

	Free	Pro
Tools	1 example	5 production-ready templates
Tool templates	—	Database, REST API, filesystem, web scraper, code runner
Transport	stdio	stdio + SSE (remote clients)
Authentication	—	API key + JWT middleware
Rate limiting	—	✅ Built-in
Logging	—	Structured logging middleware
Testing	Basic	Full test suite with Vitest
Docker	—	Dockerfile + docker-compose
Deployment	—	AWS CDK infrastructure
Error handling	Basic	Production-grade with retries
Linting	—	ESLint + Prettier configured

What's in Pro?

• 5 tool templates you can copy and customize — not just echo, but real patterns for databases, REST APIs, file systems, web scraping, and code execution
• Dual transport — serve over stdio for local use and SSE for remote clients, both from the same codebase
• Auth middleware — API key and JWT authentication out of the box
• Rate limiting — protect your server from runaway AI requests
• Structured logging — know exactly what your server is doing in production
• Docker + AWS CDK — deploy anywhere with one command
• Full test suite — every tool tested, CI-ready

👉 Get the Pro Starter Kit — $49 →

Skip the hours of setup. Start building production MCP tools today.

---

License

MIT — see LICENSE

📖 Read the Full Story

I Built a Production MCP Server Kit — Here's What I Learned — the design decisions, architecture, and lessons from building production MCP servers.