wegene-assistant MCP服务器

用于WeGene助手的MCP服务器，使用LLM来分析用户的WeGene基因检测报告。

组件

资源

一旦用户授权，其账户下的所有报告都将作为资源公开：

• 使用自定义的wegen://URI方案访问每个单独的报告
• 报告资源具有名称、描述和application/json MIME类型

工具

该服务器实现了一个工具：

• wegene-oauth: 在浏览器中启动WeGene Open API oAuth过程
  • 用户应在120秒内完成授权，以便LLM能够进一步访问报告。
• wegene-get-profiles: 读取用户WeGene账户下的个人资料列表
  • 返回个人资料的名称和ID供LLM使用。
• wegene-get-report-info: 返回报告元信息，使LLM知道有哪些报告可用。
  • 返回报告名称、描述、端点等列表
• wegene-get-report: 读取个人资料下单一报告的结果
  • 返回根据WeGene的Open API平台指定的结果JSON
  • 参数
    • report_endpoint: 要检索的报告端点
    • report_id: 要检索的报告ID
    • profile_id: 要从中检索报告的个人资料ID

配置

• 您需要WeGene Open API密钥/秘密才能使用此项目。
• 复制.env.example为.env并更新文件中的密钥和秘密。

快速开始

安装

通过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\ Support/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"
      ]
    }
  }
}