MCP Expert Server

🚀 MCP專家服務器

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

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

🚀 快速開始

MCP專家服務器利用Claude AI，為您提供智能查詢生成和文檔輔助服務。您只需按照以下步驟操作，就能輕鬆使用。

✨ 主要特性

• 智能查詢生成：通過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 Desktop配置文件中：

{
  "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 Desktop。

目錄結構

.
├── docs/                  # 您的API文檔文件
├── prompts/              # 系統提示和元數據
│   ├── system-prompt.txt    # 主系統提示
│   ├── tool-metadata.txt   # 工具描述的元數據
│   ├── query-metadata.txt  # 查詢生成的元數據
│   └── service-description.txt # 自動生成的服務描述
├── build/                # 構建輸出目錄（由腳本創建）
└── package.json          # 項目依賴和腳本配置

開發

• 使用命令npm run dev啟動開發服務器。
• 所有代碼都在src/目錄下，遵循模塊化結構。

故障排除

1. 確保Node.js版本 >= 18。
2. 檢查.env文件中的API密鑰是否正確設置。
3. 在運行腳本前安裝所有依賴：npm install

環境變量

• ANTHROPIC_API_KEY：Anthropic API的訪問密鑰。

📄 許可證

MIT License