NexonCo MCP：临床证据分析 MCP 服务器

使用说明内容（Markdown格式）

• 项目简介 NexonCo MCP 是一个基于 MCP 协议的后端服务，使用 Python 实现，主要提供一个名为 search_clinical_evidence 的工具，用于灵活筛选临床证据并汇总成报告，数据源通过 CIViC API 进行查询与整合。服务支持多传输模式（SSE、stdio），并提供简单的Web界面用于状态查看。

• 主要功能点

  • MCP 兼容工具注册：通过装饰器注册名为 search_clinical_evidence 的查询工具，供LLM客户端调用。
  • 数据获取与整合：接入 CIViC GraphQL API，基于疾病、治疗、分子特征、表型等维度筛选证据，输出包含摘要、Top10条目、来源与引用等信息的报告。
  • 数据展示与健康检测：提供 /health、/version、/ 主页等 HTTP 接口，便于监控与版本查看。
  • 实时传输支持：通过 SSE（Server-Sent Events）实现与LLM客户端的实时、流式通信，默认支持 sse 传输模式，同时具备 stdio（命令行/ Claude 风格）的运行模式。
  • 简易前端页面：根路径提供 HTML 页面，展示服务器状态、连接测试及示例、以及链接信息。

• 安装步骤

  • 环境准备：需要 Python 3.x 环境（优先使用 Python 3.8+）。
  • 安装依赖：请按需安装以下核心依赖项（示例列表，实际环境可按需调整）：pandas、requests、uvicorn、starlette、pydantic、以及 mcp 相关库（用于 MCP 服务器实现）。
  • 获取代码：将仓库代码放在本地目录中。
  • 启动服务器：
    • 使用 SSE 传输启动（推荐）：python3 src/nexonco/server.py --transport sse --host 0.0.0.0 --port 8080
    • 使用标准输入输出（stdio）启动：python3 src/nexonco/server.py --transport stdio
  • 访问入口：在浏览器打开 http://<host>:<port>/ 以查看首页界面；SSE 测试可通过界面内按钮启动与断开。

• 服务器配置（MCP客户端使用的启动配置，JSON 格式示例） { "server_name": "nexonco", "command": "python3", "args": ["src/nexonco/server.py", "--transport", "sse", "--host", "0.0.0.0", "--port", "8080"] } 注释说明：

  • server_name: MCP 服务器的唯一标识名称，应与实际部署环境保持一致。
  • command: 启动服务器所使用的命令（Python 解释器）。
  • args: 启动服务器的参数列表，包含传输模式、监听地址与端口。上述示例为通过 SSE 传输对外提供服务的配置。

• 基本使用方法

  • 启动后，LLM 客户端可通过 MCP 协议与该服务器建立通信，调用 search_clinical_evidence 工具获取临床证据分析报告。
  • 通过 SSE 传输，服务器将以事件流形式向客户端推送结果与状态更新，适合需要实时上下文信息的对话场景。
  • 服务提供简单的健康与版本接口，便于集成监控与运维。