MCP Server Starter Template (TypeScript)

**MCP Server Starter Template (TypeScript)**

A minimal but production-ready MCP server template. Copy this as your starting point.

```typescript 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-mcp-server", version: "1.0.0", });

// Define a tool server.tool( "my_tool", "Description of what this tool does and when to use it", { query: z.string().describe("Search query"), limit: z.number().default(10).describe("Max results (default: 10)"), }, async ({ query, limit }) => { // Your logic here const results = await doSomething(query, limit); return { content: [{ type: "text", text: JSON.stringify(results, null, 2), }], }; } );

// Define a resource (optional) server.resource( "config", "config://settings", async (uri) => ({ contents: [{ uri: uri.href, text: JSON.stringify({ version: "1.0" }), mimeType: "application/json", }], }) );

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

**package.json:** ```json { "name": "my-mcp-server", "version": "1.0.0", "type": "module", "bin": { "my-mcp-server": "./dist/index.js" }, "scripts": { "build": "tsc" }, "dependencies": { "@modelcontextprotocol/sdk": "^1.12.1", "zod": "^3.23.0" } } ```

**Install in Claude Desktop:** ```bash claude mcp add my-server -- npx -y my-mcp-server ```

**Common Patterns:** - Always return structured JSON in tool results - Use descriptive tool names with underscores (not hyphens) - Keep tool count under 15 - Add error handling that helps the model retry