项目简介

WeGene Assistant MCP 服务器是一个应用后端，它基于 Model Context Protocol (MCP) 构建，旨在帮助大型语言模型 (LLM) 访问和分析用户的微基因（WeGene）基因检测报告。通过这个服务器，LLM 应用可以安全、便捷地获取用户的基因数据，从而实现更智能的健康分析和个性化服务。

主要功能点

资源管理: 将用户的微基因检测报告以标准化的 资源 (Resources) 形式提供给 LLM 客户端。每个报告都通过 'wegene://' URI scheme 进行访问，包含报告的名称、描述和 'application/json' mimeType。
工具注册与执行: 提供一系列 工具 (Tools)，允许 LLM 调用外部功能，与微基因 API 交互：
- 'wegene-oauth': 启动微基因开放平台 OAuth 授权流程，用户需要在浏览器中完成授权，以便服务器能够访问其基因报告。
- 'wegene-get-profiles': 获取用户微基因账户下的所有检测人列表（Profiles），返回检测人的姓名和ID，供 LLM 选择。
- 'wegene-get-report-info': 获取所有可用的检测报告信息，包括报告的名称、描述和端点等元数据，帮助 LLM 了解可访问的报告类型。
- 'wegene-get-report': 读取指定检测人的特定检测报告结果，返回 JSON 格式的报告内容，包含基因位点、解读、风险评估等详细信息。

安装步骤

克隆仓库：将 GitHub 仓库 'https://github.com/xraywu/mcp-wegene-assistant' 克隆到本地。
安装依赖：
- 确保已安装 Python 3.8+ 和 uv (或 pip)。
- 在项目根目录下，运行命令 'uv sync --dev --all-extras' (或 'pip install -r requirements_dev.txt') 安装项目依赖。
配置环境变量：
- 复制 '.env.example' 文件并重命名为 '.env'。
- 在 '.env' 文件中，填写你的微基因开放平台 API 密钥 (WEGENE_CLIENT_ID) 和密钥Secret (WEGENE_CLIENT_SECRET)。你需要在微基因开放平台申请获得这些密钥。
Claude Desktop 配置 (或其他 MCP 客户端)：
- 找到 Claude Desktop 的配置文件 'claude_desktop_config.json'：
  - MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  - Windows: '%APPDATA%/Claude/claude_desktop_config.json'
- 在配置文件中，添加 'mcpServers' 配置项，将 WeGene Assistant 服务器添加到 MCP 服务器列表中。

服务器配置

以下 JSON 配置信息用于配置 MCP 客户端（例如 Claude Desktop）以连接到 WeGene Assistant MCP 服务器。请根据你的实际安装路径修改 '/path/to/wegene-assistant'。

{
  "mcpServers": {
    "wegene-assistant": {
      "command": "uv",  // 启动服务器的命令，这里使用 uv 虚拟环境
      "args": [
        "--directory",  // 指定 uv 虚拟环境所在的目录
        "/path/to/wegene-assistant", // 替换为你的 wegene-assistant 项目的本地路径
        "run",          // 运行 uv 虚拟环境中的程序
        "wegene-assistant" // 运行名为 "wegene-assistant" 的程序，对应 src/wegene_assistant/__init__.py 中的 main 函数
      ]
    }
  }
}

注意:

请将 '/path/to/wegene-assistant' 替换为你实际克隆的 'wegene-assistant' 仓库在本地的绝对路径。
如果使用 pip 安装依赖，可以将 'command' 修改为 'python'，'args' 修改为 '["/path/to/wegene-assistant/src/wegene_assistant/init.py"]'。

基本使用方法

启动 MCP 服务器: 配置 Claude Desktop (或其他 MCP 客户端) 后，启动客户端，客户端会自动尝试连接并启动 WeGene Assistant MCP 服务器。
LLM 调用工具: 在 LLM 应用中，可以指示 LLM 调用以下工具来与 WeGene Assistant MCP 服务器交互：
- 首先调用 'wegene-oauth' 工具进行 OAuth 授权。用户需要在浏览器中完成授权流程。
- 授权成功后，调用 'wegene-get-profiles' 工具获取检测人列表。
- 然后，调用 'wegene-get-report-info' 工具获取可用的报告信息。
- 最后，根据需要调用 'wegene-get-report' 工具，并提供 'report_endpoint', 'report_id', 'profile_id' 参数来获取具体的基因检测报告内容。
LLM 分析报告: LLM 可以利用获取的基因检测报告 JSON 数据进行分析，例如解读健康风险、遗传特征等。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息