Skip to main content
Glama

jyb-drug-mcp

津医保(天津市医保局 App)「医药云平台 · 定位药品上架药店」功能的 MCP (Model Context Protocol) server。

让任意支持 MCP 的 AI 客户端(Claude Desktop、omp 等)可以直接:

  • 按药品名检索药品目录(拿到 drugCode)

  • 查询该药品的有货机构列表:机构名、最新价格、与你的距离、最后交易日期(lastTrnsDate)、坐标

  • 一步式:药品名 → 自动匹配候选 → 有货药店列表

English: An MCP server exposing the Tianjin Medical Insurance app's "drug → stocking pharmacies" API (search drugs, query stocking institutions with price / distance / last transaction date).

免责声明:本项目仅供学习与个人研究,通过自己账号的会话凭据访问自己可见的数据。 请遵守相关服务条款与当地法规,勿用于商业用途或高频爬取。与官方无关。使用风险自负。

工作原理(协议摘要)

业务接口位于 https://jyt.ylbz.tj.gov.cn/app-prod/,HTTPS 之外还有一层应用层保护:

  • 报文加密:请求与响应体均为 AES-256-CBC(PKCS7) 密文的 Base64; key(32 字符)/ IV(16 字符)为登录时下发、会话级有效的 UTF-8 字符串

  • 请求签名(均不覆盖 body):

    • jyb-signature = md5(timestamp + nonce + token + "jyb4443")

    • X-Tif-Signature = SHA256(timestamp + paastoken + nonce + timestamp)(paastoken 为空)

  • 鉴权:请求头 token(登录会话)

三个会话凭据(token / key / iv)需要通过一次抓包获取,见 docs/OBTAINING_CREDENTIALS.md(含自动化探针脚本)。

Related MCP server: drug-safety-mcp

安装

pip install "mcp<2" pycryptodome

要求 Python 3.10+。

配置凭据

cp .env.example .env   # 填入 JYB_TOKEN / JYB_AES_KEY / JYB_AES_IV

server 启动时自动加载同目录 .env(不覆盖已有环境变量);.env 已被 .gitignore 排除。凭据获取的完整流程见 docs/OBTAINING_CREDENTIALS.md。

MCP 客户端配置

Claude Desktop / 通用 stdio 配置:

{
  "mcpServers": {
    "jyb-pharmacy": {
      "type": "stdio",
      "command": "python3",
      "args": ["/path/to/jyb-drug-mcp/server.py"]
    }
  }
}

omp:在 ~/.omp/agent/mcp.json 的 mcpServers 下加入同样条目。

工具

工具

说明

search_drug(drug_name, page, page_size)

药品名 → 候选药品(drugCode / 规格 / 厂家)

find_orgs(drug_code, latitude, longitude, ...)

drugCode → 有货机构(价格 / 距离 / 坐标 / lastTrnsDate)

find_drug_stores(drug_name, latitude, longitude)

一步式:自动尝试候选,返回首个有货结果

update_session(token, aes_key, aes_iv)

凭据过期后热刷新(也可直接改 .env 重启)

已知边界

  • 凭据是会话级的:App 重新登录即失效,重新跑一遍抓包流程即可

  • purcRcdFlag(采购记录视角)公开数据目前基本为空;采购明细未开放

  • 行政区划参数当前固定为天津(admdvs=120000)

开发

python3 smoke_test.py        # 配置好 .env 后运行全链路冒烟测试

capture_addon.py 是抓凭据用的 mitmproxy 插件(见凭据文档),不属于运行时依赖。

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables querying DrugSea/Yaohai pharmaceutical databases via MCP, including search, details, and facets for marketed China products, CDE regulatory pipeline, and cross-database queries.
      33 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI clients to query authoritative medical sources such as FDA, WHO, PubMed, RxNorm, and ClinicalTrials.gov for drug information, medical literature, health statistics, clinical guidelines, and pediatric resources through local MCP tools.
      74 npm
      ISC