MCP 服务器模板 🛠️

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

功能

• 使用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 绝对路径到MCP服务器/build/index.js

与Claude Desktop一起使用

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

{
  "mcpServers": {
    "your-mcp-name": {
      "command": "node",
      "args": ["绝对路径到MCP服务器/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