MCP 服务器

Wegene Assistant MCP Server

利用大型语言模型分析用户的微基因（WeGene）基因检测报告，通过自定义 URI 方案提供对报告数据的访问，并通过 OAuth 认证和 API 使用实现个人资料和报告管理。

Tools

wegene-oauth

Authorizing a user's account using WeGene Open API with oAuth2 protocol and retrieve a valid access token for further use

wegene-get-profiles

Retrieve all the profiles under the current account

wegene-get-report-info

Get all available report information

wegene-get-report

Get a specific genetic test report from a profile

README

wegene-assistant MCP 服务器

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

组件

资源

一旦用户获得授权，他/她帐户下的所有报告都将作为资源公开：

用于访问每个单独报告的自定义 wegene:// URI 方案
报告资源具有名称、描述和 application/json mimetype

工具

服务器实现了一个工具：

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 密钥/secret 才能使用此项目。
将 .env.example 复制为 .env 并更新文件中的密钥和 secret。

快速开始

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 WeGene Assistant：

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

本地安装

准备 MCP 服务器

克隆此项目
在项目的根文件夹下运行 uv sync --dev --all-extras

Claude Desktop 配置

在 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"
      ]
    }
  }
}