MCP 服务器

MCP Server Template 🚀

构建 Claude 和其他 AI 助手 MCP (模型上下文协议) 服务器的模板

3dyuval

开发者工具

访问服务器

README

MCP 服务器模板 🚀

一个用于构建模型上下文协议 (MCP) 服务器的干净模板。

什么是 MCP？

模型上下文协议 (MCP) 是 Anthropic 开发的一个开放标准，它使像 Claude 这样的人工智能系统能够与各种数据源和工具无缝交互，从而促进安全、双向的连接。

此模板提供了一个起点，用于构建您自己的 MCP 服务器，该服务器可以与 Claude Desktop、Cursor 或任何其他 MCP 客户端一起使用。

模板特性

此模板包括：

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

前提条件 🔧

在开始之前，请确保您已具备：

您要包装的任何服务的 API 密钥（如果适用）
Node.js (v20 或更高版本)
像 Claude Desktop 或 Cursor 这样的 MCP 客户端

安装 ⚡

克隆此模板仓库：

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

安装依赖项：

npm install

构建项目：

npm run build

自定义指南 🔧

要为您的 MCP 服务器自定义此模板：

使用您的服务器名称和详细信息更新 package.json
修改 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

打开 Cursor 设置
导航到 Features > MCP Servers
单击 "+ Add New MCP Server" 按钮
填写以下信息：
- Name: 输入服务器的昵称（例如，“your-server-name”）
- Type: 选择 "command" 作为类型
- Command: 输入运行服务器的命令：
```
env YOUR_API_KEY=your-api-key node /path/to/your/build/index.js
```