Crazyrabbitltc MCP Expert Server

🚀 MCP專家服務器

MCP專家服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，藉助Claude AI為用戶提供智能查詢生成和文檔輔助功能。它能夠對用戶的API文檔進行分析，並提供兩大實用工具：

• create-query：依據自然語言請求生成查詢。
• documentation：根據問題提供相關文檔信息。

🚀 快速開始

先決條件

• Node.js >= 18
• 擁有用於Claude的Anthropic API密鑰

📦 安裝指南

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

npm install

3. 創建一個.env文件，將您的Anthropic API密鑰添加其中：

ANTHROPIC_API_KEY=your_api_key_here

🔧 設置步驟

在運行服務器之前，請完成以下操作：

1. 構建項目並運行設置腳本：

npm run build
npm run setup

此操作將完成以下任務：

• 創建所需的目錄 (docs/ 和 prompts/)。
• 創建默認提示文件。
• 生成初始服務描述。

2. 將您的API文檔文件添加到docs/目錄中（支持.txt、.md和.json文件）。
3. 可在prompts/目錄中進行自定義提示：
   • system-prompt.txt：Claude的主要系統提示。
   • tool-metadata.txt：工具描述的額外上下文。
   • query-metadata.txt：查詢生成的額外上下文。
   • service-description.txt：自動生成的服務描述。

💻 使用示例

獨立服務器

啟動服務器：

npm start

該服務器通過模型上下文協議（MCP）提供兩個工具：

基礎用法

• create-query：根據自然語言請求生成查詢

{
    "name": "create-query",
    "arguments": {
        "request": "查找過去一週內註冊的所有用戶"
    }
}

• documentation：從文檔中獲取信息

{
    "name": "documentation",
    "arguments": {
        "request": "如何進行API請求認證？"
    }
}

Claude桌面集成

1. 將以下配置添加到您的Claude桌面配置文件中：

{
    "mcpServers": {
        "expert": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"],
            "env": {
                "ANTHROPIC_API_KEY": "your_api_key_here"
            }
        }
    }
}

2. 將/ABSOLUTE/PATH/TO/expert-server替換為服務器安裝的實際絕對路徑。
3. 重啟Claude桌面。

🔧 技術細節

開發相關

• 構建項目：

npm run build

• 該服務器使用TypeScript進行開發，並遵循模塊化架構。
• 所有Claude交互均由ExpertService類處理。
• 調試日誌記錄到stderr，帶有[DEBUG]前綴。

故障排除

如果您遇到連接問題，請按以下步驟排查：

1. 確保已運行設置腳本：

npm run setup

2. 檢查prompts/目錄下所有必需文件是否存在。
3. 驗證您的ANTHROPIC_API_KEY是否正確設置。
4. 在Claude桌面配置中使用絕對路徑。
5. 查看調試日誌以獲取更多信息。

環境變量

• ANTHROPIC_API_KEY：Anthropic API的密鑰，用於訪問Claude模型。

📄 許可證

此項目受MIT License保護。