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: kfda-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 下加入同样条目。

工具

已知边界

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

• purcRcdFlag（采购记录视角）公开数据目前基本为空；采购明细未开放

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

开发

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

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

License

MIT