MCP Server Template 🚀

MCP 服务模板 🚀

用于构建 Model Context Protocol (MCP) 服务的简洁模板。

什么是 MCP？

Model Context Protocol (MCP) 是 Anthropic 开发的一项开放标准，可让 Claude 等 AI 系统与各种数据源和工具无缝交互，从而建立安全的双向连接。

此模板为构建你自己的 MCP 服务提供了起点，可与 Claude Desktop、Cursor 或任何其他 MCP 客户端配合使用。

模板功能

此模板包含：

• 基本服务结构和 MCP SDK
• 带注释占位符的示例工具定义
• 错误处理设置
• 通过 dotenv 配置环境变量

先决条件 🔧

开始之前，请确保你具备：

• 你要封装的服务的 API 密钥（如适用）
• Node.js（v20 或更高版本）
• Claude Desktop 或 Cursor 等 MCP 客户端

安装 ⚡

1. 克隆此模板仓库：

git clone https://github.com/yourusername/mcp-server-template.git
cd mcp-server-template

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

自定义指南 🔧

要将此模板自定义为你自己的 MCP 服务：

1. 在 package.json 中更新服务名称和详细信息
2. 修改 src/index.ts 以：
   • 定义 API 响应接口
   • 添加实际工具及其架构
   • 实现工具功能
   • 更新格式化逻辑

要修改的关键文件

• src/index.ts：服务的主要实现
• package.json：软件包元数据和依赖项
• .env：创建此文件以存储 API 密钥（请确保将其添加到 .gitignore）

运行服务 🖥️

你可以直接运行服务：

npm run build
node build/index.js

与 MCP 客户端集成

配置 Claude Desktop 应用

macOS：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Open the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows：

code %APPDATA%\Claude\claude_desktop_config.json

添加服务配置：

{
  "mcpServers": {
    "your-server-name": {
      "command": "node",
      "args": ["/path/to/your/build/index.js"],
      "env": {
        "YOUR_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置 Cursor

1. 打开 Cursor Settings
2. 前往 Features > MCP Servers
3. 点击“+ Add New MCP Server”按钮
4. 填写以下信息：
   • Name：输入服务的昵称（例如，“your-server-name”）
   • Type：选择“command”作为类型
   • Command：输入运行服务的命令：

     env YOUR_API_KEY=your-api-key node /path/to/your/build/index.js
     

模板结构说明

• 服务设置：模板使用 stdio 传输创建基本 MCP 服务
• 工具定义：带注释占位符的示例工具架构
• 错误处理：带控制台日志记录的基本错误处理设置
• 请求处理：使用 switch/case 结构处理工具请求的模板

贡献

欢迎将此模板用作构建你自己的 MCP 服务的起点。如果你改进了模板，请考虑通过拉取请求贡献回来！

致谢 ✨

• Model Context Protocol：提供 MCP 规范
• Anthropic：提供 Claude Desktop
• Tavily MCP Server：此模板基于该项目构建