MCP Template

🚀 MCP 服务器模板

本模板十分简洁，可用于构建 模型上下文协议 (MCP) 服务器，为相关开发工作提供便利。

🚀 快速开始

模型上下文协议（MCP）是由 Anthropic 开发的开放标准，能让人工智能系统（如 Claude）与各类数据源和工具实现安全的双向无缝交互。本模板为你搭建自己的 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：

# 如果文件不存在，则创建配置文件
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 在 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 设置。
2. 导航到功能 > MCP 服务器。
3. 点击“+ 添加新 MCP 服务器”按钮。
4. 填写以下信息：
   • 名称：输入服务器的昵称（例如，“your-server-name”）。
   • 类型：选择“命令”作为类型。
   • 命令：输入运行服务器的命令：

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

🔧 技术细节

模板结构说明

• 服务器设置：模板创建了一个带有 stdio 传输的基本 MCP 服务器。
• 工具定义：有示例工具模式，还带有注释的占位符。
• 错误处理：配置了基本的错误处理设置和控制台日志记录。
• 请求处理：采用 switch/case 结构的请求处理模板。

📄 许可证

文档中未提及许可证相关信息。

贡献

你可以随意使用此模板来搭建自己的 MCP 服务器。若你对模板进行了改进，欢迎通过拉取请求进行贡献！

致谢 ✨

• 模型上下文协议 提供了 MCP 规范。
• Anthropic 的 Claude Desktop。
• Tavily MCP 服务器，本模板基于该服务器。