MCP Wegene Assistant

🚀 我們基因助手 MCP 服務器

我們基因助手 MCP 服務器藉助大語言模型（LLM），對用戶的 WeGene 基因檢測報告進行分析，為用戶提供更深入的基因數據洞察。

🚀 快速開始

📦 安裝指南

通過 Smithery 安裝

若要通過 Smithery 自動安裝 WeGene 助手用於 Claude 桌面版本，可執行以下命令：

npx -y @smithery/cli install @xraywu/mcp-wegene-assistant --client claude

本地安裝

準備 MCP 服務器

1. 克隆此項目。
2. 在項目的根文件夾下運行 uv sync --dev --all-extras。

配置 Claude 桌面版本

• MacOS：配置文件路徑為 ~/Library/Application\ 支持/Claude/claude_desktop_config.json。
• Windows：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json。

在配置文件中添加以下內容：

{
  "mcpServers": {
    "wegene-assistant": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/wegene-assistant",
        "run",
        "wegene-assistant"
      ]
    }
  }
}

✨ 主要特性

組件

資源

用戶完成授權後，其賬戶下的所有報告將被暴露為資源：

• 可使用自定義的 wegene:// URI 方案訪問每個個體報告。
• 每個報告資源包含名稱、描述和 application/json 格式的內容類型。

工具

該服務器實現了以下工具：

• wegene-oauth：在瀏覽器中啟動 WeGene 開放 API OAuth 流程。用戶需在 120 秒內完成授權，以便 LLM 進一步訪問報告。
• wegene-get-profiles：讀取用戶 WeGene 賬戶下的個人資料列表，返回個人資料的名稱和 ID，供 LLM 使用。
• wegene-get-report-info：返回報告元信息，使 LLM 知道可用的報告，返回報告名稱、描述、端點等信息列表。
• wegene-get-report：讀取某個個人資料下的單個報告結果，返回 WeGene 開放 API 平臺指定的報告 JSON 結果。該工具的參數如下：
  • report_endpoint：要從哪個端點獲取的報告。
  • report_id：要獲取的報告 ID。
  • profile_id：要從哪個個人資料獲取報告。

🔧 技術細節

配置

• 您需要 WeGene 開放 API 的密鑰/秘密來使用此項目。
• 複製 .env.example 並將其命名為 .env，然後在文件中更新密鑰和秘密。