MCP Server Boilerplate

MCP Server Boilerplate

MCP Server 模板是一个 Node.js 示例，演示了如何使用自定义工具构建 MCP 服务器，包括从配置文件加载环境变量，以便与像 Cursor AI 这样的AI辅助环境无缝集成。

GitHub
Created Bylucianoayreslucianoayres

MCP (Model Context Protocol) 是一个框架，允许将自定义工具集成到 AI 辅助开发环境（如 Cursor AI）中。本指南帮助你快速设置 MCP 服务器。

前提条件

  • Node.js: 版本 20 或更高

快速设置

  1. 克隆并安装

    git clone <repository_url>
cd <repository_directory>
npm install

  2. 配置 Cursor 集成

    在 ./cursor/mcp.json 中设置：

    {
  "mcpServers": {
    "MCP Server Boilerplate": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-server.js"],
      "env": {
        "API_KEY": "abc-1234567890"
      }
    }
  }
}

    提示：使用 which node 查找 Node.js 的绝对路径

  3. 验证安装

    在 Cursor Composer 中使用自然语言提示测试工具：

    add 3 and 5

    或

    what is my API key?

主要功能

  • MCP 集成: 向 LLM 驱动的 IDE 暴露工具
  • 示例工具: add (加法) 和 getApiKey (环境变量检索)
  • 输入验证: 使用 Zod 进行模式验证
  • 标准 I/O 传输: 通过 StdioServerTransport 与开发环境集成

进阶配置

可选择将 mcp.json 移至全局 Cursor AI 配置目录 ~/.cursor 以全局启用 MCP 服务器。

参考资源

许可证

此项目根据 MIT 许可证 发布。