MCP 服务器模板 🛠️

用于构建自己的模型上下文协议（MCP）服务器的起始模板。此模板提供了创建自定义 MCP 所需的基本结构和设置，这些 MCP 可以与 Cursor 或 Claude Desktop 一起使用。

<a href="https://glama.ai/mcp/servers/vnt96edg3a"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=2448142412,414121817&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Server Template MCP 服务器" /> </a>

特性

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

项目结构

mcp-server-template/
├── index.ts        # 主服务器实现
├── package.json    # 项目依赖
├── tsconfig.json   # TypeScript 配置
└── build/         # 编译后的 JavaScript 输出

开始使用

1. 克隆此模板：

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

2. 安装依赖：

pnpm install

3. 构建项目：

pnpm run build

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

与 Cursor 一起使用

1. 前往 Cursor 设置 -> MCP -> 添加新 MCP 服务器
2. 配置您的 MCP：
   • 名称：[选择您自己的名称]
   • 类型：命令
   • 命令：node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js

与 Claude Desktop 一起使用

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

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

开发

模板包括 index.ts 中的示例工具实现。要创建您自己的 MCP：

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

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

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

server.tool(
  "your-tool-name",
  "您的工具描述",
  {
    // 使用 Zod 模式定义您的工具参数
    parameter: z.string().describe("参数描述"),
  },
  async ({ parameter }) => {
    // 在这里实现您的工具逻辑
    return {
      content: [
        {
          type: "text",
          text: "您的工具响应",
        },
      ],
    };
  }
);

3. 构建并测试您的实现：

npm run build

贡献

欢迎提交问题和改进请求！

许可证

MIT

<中文翻译>