med-lit-mcp

这是一个用于减少医护人员“查资料”时间的 MCP 服务器。可以直接从 Claude 检索 PubMed、临床试验、药品信息、诊疗指南和诊疗报酬主数据。

据美国调查，医生每诊疗1小时需要花费1.5〜2小时用于行政事务和记录。其中一部分就是文献、药品说明书和制度的确认。这个服务器瞄准的就是这个痛点。

这个服务器不做的事情

本软件不是医疗器械程序（SaMD）。 药机法上的适用性由“贡献度（对医学判断的影响程度）”和“风险（故障时的危害）”来判断。本服务器仅指出一次信息的所在位置，不进行医学判断，因此属于不适用范围内。

在设计上，不会做以下事情：

• 提示诊断名称、列举鉴别诊断

• 推荐治疗方案、药物选择、给药剂量

• 根据检查值或影像进行所见判定

• 对摘要或药品说明书进行摘要、改写（按原文返回）

返回的只有出处和原文。判断请由医护人员进行。

这一方针由代码保证。src/med_lit_mcp/guard.py 中放置了禁止表达的规则，并通过测试检查服务器自身生成的文本（工具说明、注释、错误消息）中是否混入了暗示判断的表达。

处理的数据

完全不处理患者的个人信息。 对外发送的只有搜索关键词。通信目标仅限于以下4个主机，除此之外的通信会抛出异常（http.py 中的 ALLOWED_HOSTS）。

获取结果会缓存在本地 SQLite 中（默认 ~/.cache/med-lit-mcp/）。导入诊疗报酬主数据后，该搜索无需网络即可运行。

安装

uvx --from git+https://github.com/fc0web/med-lit-mcp med-lit-mcp

或者 clone 后：

git clone https://github.com/fc0web/med-lit-mcp
cd med-lit-mcp
uv sync
uv run med-lit-mcp

注册到 Claude Desktop / Claude Code

在 claude_desktop_config.json（Claude Desktop）或 .mcp.json（Claude Code）中追加。

{
  "mcpServers": {
    "med-lit": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/fc0web/med-lit-mcp", "med-lit-mcp"],
      "env": {
        "NCBI_EMAIL": "you@example.com"
      }
    }
  }
}

使用 Claude Code 时，一行即可注册。

claude mcp add med-lit -- uvx --from git+https://github.com/fc0web/med-lit-mcp med-lit-mcp

工具

使用示例

「オルフォルグリプロンの第3相試験を、2025年以降のRCTに絞って探して」
  → search_pubmed(term="orforglipron", year_from=2025, study_types=["rct"])

「初診料の点数を調べて」
  → import_shinryo_master(kind="shinryo")   # 初回のみ
  → search_shinryo_hoshu(term="初診料")

设置（环境变量）

没有 API 密钥也可以运行。速率限制在超限时不是抛出异常，而是通过等待和重试来处理。

使用公司代理或自有 CA 时

MCP 客户端以子进程方式启动服务器时，只继承最小限度的环境变量。如果企业网络使用自有认证机构，TLS 验证可能会失败。请在配置的 env 中明确指定。

"env": {
  "SSL_CERT_FILE": "/path/to/ca-bundle.crt",
  "REQUESTS_CA_BUNDLE": "/path/to/ca-bundle.crt",
  "HTTPS_PROXY": "http://proxy.example.jp:8080"
}

做不到的事情（坦诚说明）

• Minds 指南库的正文检索。Minds 在浏览器端渲染搜索结果，也没有公开 API。用无头浏览器获取在技术上可行，但对规格变更的抵抗力弱，使用条件也不明确，因此 v0.1 不实施，仅提供检索 URL。

• PMDA 药品说明书的正文获取。同样没有公开 API，因此以 KEGG 为一次来源，并同时附上 PMDA 的检索 URL。药品说明书的记载才是正本，实际工作中务必在 PMDA 确认原文。

• 牙科、调剂主数据。v0.1 仅包含医科诊疗行为、药品、特定器材三种。

开发

uv sync
uv run pytest              # 外部APIを叩かないテスト
uv run pytest -m live      # 実APIへの疎通テスト
uv run ruff check .

出处

• NCBI E-utilities

• ClinicalTrials.gov API v2

• KEGG REST API

• 诊疗报酬信息提供服务

• Minds 指南库

• PMDA 药品检索

许可证

MIT。

免责声明

本软件不是医疗器械程序。不用于诊断、治疗判断，输出的最终确认责任在于使用者。制度、点数、药价、指南会进行修订，实际工作中务必通过一次信息确认。