MCP 服务器模板🛠️

用于构建您自己的模型上下文协议 (MCP) 服务器的入门模板。此模板提供了创建可与 Cursor 或 Claude Desktop 配合使用的自定义 MCP 所需的基本结构和设置。

特征

使用 TypeScript 设置基本的 MCP 服务器
示例工具实现
即用型项目结构
使用@modelcontextprotocol/sdk构建

Related MCP server: MCP Server Boilerplate

项目结构

mcp-server-template/ ├── index.ts # Main server implementation ├── package.json # Project dependencies ├── tsconfig.json # TypeScript configuration └── build/ # Compiled JavaScript output

入门

克隆此模板：

git clone [your-repo-url] my-mcp-server cd my-mcp-server

安装依赖项：

pnpm install

构建项目：

pnpm run build

这将生成/build/index.js文件 - 已编译的 MCP 服务器脚本。

与游标一起使用

前往“光标设置”->“MCP”->“添加新的 MCP 服务器”
配置您的 MCP：
- 姓名：[选择您自己的名字]
- 类型：命令
- 命令： node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js

与 Claude Desktop 一起使用

将以下 MCP 配置添加到您的 Claude Desktop 配置中：

{ "mcpServers": { "your-mcp-name": { "command": "node", "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"] } } }

发展

该模板在index.ts中包含一个示例工具实现。要创建您自己的 MCP，请执行以下操作：

修改index.ts中的服务器配置：

const server = new McpServer({ name: "your-mcp-name", version: "0.0.1", });

使用server.tool()方法定义您的自定义工具：

server.tool( "your-tool-name", "Your tool description", { // Define your tool's parameters using Zod schema parameter: z.string().describe("Parameter description"), }, async ({ parameter }) => { // Implement your tool's logic here return { content: [ { type: "text", text: "Your tool's response", }, ], }; } );