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 服務器，本模板基於該服務器。