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",
        },
      ],
    };
  }
);