MCP JS Server Template

🚀 MCP JS 服務器模板

本項目是一個簡化模板，用於創建與Claude Desktop集成的Model Context Protocol (MCP) 服務器。它為開發自定義MCP服務器提供了基本結構，能有效減少樣板代碼。

🚀 快速開始

本模板可幫助你快速搭建與Claude Desktop集成的MCP服務器，減少開發中的重複工作。

✨ 主要特性

• 實現標準的MCP服務器初始化。
• 提供兩個基本工具：about 和 hello。
• 遵循MCP協議版本2024 - 11 - 05。
• 使用 @modelcontextprotocol/sdk 進行服務器實現。
• 包含錯誤處理和日誌記錄。

📦 安裝指南

環境準備

• Node.js (v16或更高版本)
• Claude Desktop
• @modelcontextprotocol/sdk npm包

安裝步驟

1. 克隆倉庫。
2. 安裝依賴：

npm install @modelcontextprotocol/sdk

📚 詳細文檔

Claude Desktop配置

需將相關配置添加到Claude Desktop配置文件中：

• 位置：
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
• 配置示例：

{
  "mcpServers": {
    "template-server": {
      "command": "node",
      "args": [
        "/full/path/to/simplified-template-mcp-server.js"
      ],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

可用工具

1. about

此工具可返回MCP服務器的信息。

2. hello

該工具提供問候語，支持可選的名稱參數。 Claude中的示例使用：

hello with name="Claude"

擴展模板

若你想創建自己的MCP服務器，可按以下步驟操作：

1. 複製此模板。
2. 修改TOOLS數組。
3. 在server.fallbackRequestHandler中實現自定義工具處理程序。
4. 更新服務器名稱和版本。

侷限性

• 錯誤處理簡單。
• 沒有高級安全功能。
• 僅作為自定義實現的起點。

💻 使用示例

基礎用法

在Claude中使用hello工具：

hello with name="Claude"

🔧 技術細節

本項目使用 @modelcontextprotocol/sdk 實現MCP服務器，遵循MCP協議版本2024 - 11 - 05。在開發過程中，可通過修改TOOLS數組和實現自定義工具處理程序來擴展服務器功能。同時，項目包含了簡單的錯誤處理和日誌記錄機制。

🤝 貢獻

歡迎大家為項目貢獻力量！你可以提交拉取請求或打開問題。

📄 許可證

本項目採用MIT License。