医药数据社 · MCP 接口

医药数据库 MCP 接口 — 接入 Claude / Cursor 直接查

把自建医药数据库做成 21 个只读 MCP 工具,交给你的 AI 客户端调用。一个 URL、一个 API Key,按次计费,单次响应锁死 32KB。

只读 · 按次计费单次响应 ≤ 32KB无需自建数据库
MCP 端点https://medicine.shanchuangkj.com/mcp/
X-API-Keymds-••••••••••••••••••••••••
接入信息就这两行:URL + X-API-Key 请求头

这是什么

MCP(Model Context Protocol)是让 AI 客户端调用外部工具的协议。装好之后,你在 Claude 或 Cursor 里问「PD-1 抑制剂在国内的临床试验进展」,它会自己去医药数据库检索,把返回的数据行整理进回答 —— 而不是凭记忆编。

你现在的方式
接上医药数据社 MCP
通用大模型凭记忆作答,来源说不清
答案里的数据来自我们的检索结果,含记录 id 与来源链接
自己买数据库、搭服务、维护清洗
只要一个 URL 和一个 Key,数据库口径由我们维护
通用联网搜索抓网页,噪声大
只查结构化医药库:药品 / 靶点 / 适应症 / 试验 / 交易 / 投融资 / 销量
一次问一大段,token 花得没数
单次响应硬上限 32KB、单页最多 50 行,超了直接拒
和主站的查询有什么区别

主站是「用一句话提问,Agent 跨库检索后交付一份结构化调研报告」(150 积分/次,¥15);本接口是把检索能力交给你自己的 Agent 编排 —— 返回 JSON 数据行,不写报告,按调用次数计费。要成品的选主站,要数据源的选这里。

适合谁

  • 医药投研 / BD 分析师在 Claude、Cursor 里直接问某靶点的在研管线、某企业的交易与融资历史,不用把数据导出来再做表
  • 做医药 AI 应用的开发者给你的 Agent 挂一个真实数据源,免去自建医药库的采购、清洗与维护
  • 临床 / 注册 / 医学事务查适应症树、临床试验期别与终点、会议摘要原文
  • 已经在用数据库接口的人想验证「大模型接了真数据」到底能省多少返工,¥9.9 一次体验卡够跑 100 次

响应是受控的

买家最贵的是 token。这一节不是合规声明,是这条产品线的核心设计 —— 每条都写死在代码里,构建自证逐条断言过。

单次响应 ≤ 32KB
超限直接报 response_too_large,并提示缩小 limit 或 fields,不返回半坨数据
默认 20 行、单页硬上限 50 行
limit=999 会被压到 50 而不是报错,多与否由 more 字段如实告诉你
查不到就返回 count: 0
空结果给空数组结构,不给「抱歉没找到」这类会污染上下文的自然语言
只读、必须带条件
没有全表导出、没有表结构导出工具;无条件裸调用一律拒绝,一条 SQL 都不发
元调用不计费
目录工具 list_capabilities 免费,接入后先调它拿全量清单,不烧次数
每个响应带水印
响应体里固定含 watermark 字段,数据流转出去也能追到出处

能查什么

9 大能力域、21 个计费工具。域名与主站能力域同源,工具名与 MCP 服务的注册表逐字一致。

药品与研发管线6 个工具
药品标准库、研发阶段、原研单位、作用靶点、适应症
药名 / 类型 / 国内与全球研发阶段 / 靶点 / 适应症 / 专利法律状态与届满日
search_drugsget_drug_detailsearch_drugs_by_targetsearch_drugs_by_indicationsearch_patentsget_patent_detail
靶点与机制2 个工具
靶点结构树、单靶点、成分类型、作用机制
靶点树:别名、父节点、子靶点、该靶点关联药品数
search_targetsget_target_detail
适应症与疾病2 个工具
适应症标准库、适应症树、疾病分类
适应症树:中英文名、别名、层级、药品数与试验数
search_indicationsget_indication_detail
临床试验2 个工具
临床试验详情库、招募人数、各期进展、疗效与安全性评价
中文库与 ClinicalTrials.gov 全球库:期别、申办方、入组人数、入排标准;状态按全球库英文枚举筛(中文库该字段实测无状态语义)
search_clinical_trialsget_clinical_trial_detail
公司与机构2 个工具
公司标准库、母子公司结构、中外企性质、研发热度
公司标准库:中英文名、注册地、上市类型、母公司,以及管线/交易/融资计数
search_companiesget_company_detail
BD 交易2 个工具
知识产权交易库:license-in/out、首付款、总金额、转让受让双方
BD 交易:license-in/out、首付款、总金额、里程碑、转让与受让双方
search_dealsget_deal_detail
投融资2 个工具
投资事件标准库、投资机构、募资端数据
投融资事件与机构:轮次、金额、领投跟投、机构关注阶段与赛道
search_investmentssearch_investors
指南与文献2 个工具
临床指南、专家共识、文献与证据检索(Agent 联网 + 库内证据)
医学会议摘要(ASCO / ESMO / SABCS 等):标题、作者、摘要正文与原文链接
search_meeting_reportsget_meeting_report_detail
药品销量与市场1 个工具
药品销售额与逐年趋势(2016–2024)、医院与线上销售规模、适应症市场规模
药品销售额 2016–2024:医院端、线上电商(京东/天猫/抖音)、药品汇总三张表
search_market_sales

三步接入

  1. 1买卡密闲鱼搜「医药数据社 MCP」下单,拿到一串 MDSC- 开头的卡密。
  2. 2兑换出 Key在本页「卡密兑换」输入卡密,立刻拿到 mds- 开头的 API Key。Key 只完整显示一次,存好。
  3. 3填进客户端把下面的 URL 与 Key 写进你的 MCP 配置,重启客户端即可看到 22 个工具(1 个免费目录 + 21 个查询)。
Cursor.cursor/mcp.json
项目级 .cursor/mcp.json 或全局 ~/.cursor/mcp.json
{
  "mcpServers": {
    "medical-data": {
      "url": "https://medicine.shanchuangkj.com/mcp/",
      "headers": { "X-API-Key": "mds-你的Key" }
    }
  }
}
Claude Desktopclaude_desktop_config.json
设置 → 开发者 → 编辑配置文件;用 mcp-remote 桥接,兼容各版本
{
  "mcpServers": {
    "medical-data": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://medicine.shanchuangkj.com/mcp/",
               "--header", "X-API-Key:mds-你的Key"]
    }
  }
}
Claude CodeClaude Code
一条命令,写进项目 .mcp.json 或用户配置
claude mcp add --transport http medical-data https://medicine.shanchuangkj.com/mcp/ \
  --header "X-API-Key:mds-你的Key"

也可以绕开客户端,直接打一次 JSON-RPC

这就是 MCP 在网络上真实跑的东西:一次 POST,一个 JSON-RPC 请求。

POST https://medicine.shanchuangkj.com/mcp/
X-API-Key: mds-你的Key
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/call",
 "params":{"name":"search_drugs","arguments":{"keyword":"奥希替尼","limit":5}}}
{
  "count": 5,
  "rows": [ { "id": 1058973, "name": "奥希替尼", "category": "化学药",
              "stage_china": "批准上市", "target": "EGFR(批准上市)" } ],
  "more": false,
  "truncated": false,
  "watermark": "©医药数据社"
}

返回体固定五个键:count / rows / more / truncated / watermark。

价格

三档套餐,按调用次数计费(只给成功的工具调用计数)。买卡在闲鱼,兑换在本页。

体验卡
¥9.9
有效期
7 天
每日上限
100 次
总量
100 次
100 次总量,用完即止(即使没到期)
月卡
¥99
有效期
30 天
每日上限
500 次
总量
不限
每日 500 次,30 天内不限总量

对照:主站一份结构化调研报告 150 积分 = ¥15;本接口 ¥9.9 可跑 100 次检索。两者不是同一个产品,别混着用。

卡密兑换

输入 MDSC- 开头的卡密,兑换属于你的 API Key。每张卡密只能兑换一次。

兑换只在本页与接口之间完成,卡密不会存进浏览器。

想自己发请求:
POST https://medicine.shanchuangkj.com/mcp/redeem
Content-Type: application/json

{"code": "MDSC-XXXX-XXXX-XXXX-XXXX"}

这几类查不到

先说清楚,免得你花钱试错。下面这三类数据不在库内,接口里没有对应工具。

查不到原因建议改查
线下连锁药店动销销售数据覆盖医院与线上电商(京东 / 天猫 / 抖音),不含线下药店动销明细可改查该药的医院与线上销售额、逐年趋势与主要竞品对比
股价 / 财报 / 市值医学库不包含证券行情与财务报表数据可改查公司管线与研发阶段、BD 交易金额、投融资轮次
药品价格 / 医保支付标准医学库不包含药品价格与医保支付数据可改查该药的适应症与竞品格局

常见问题

MCP 接口和你们网站的查询有什么区别?
网站是自然语言提问,Agent 跨库检索后交付一份结构化调研报告,150 积分一次;本接口把医药库的检索能力以 21 个只读工具暴露给你自己的 AI 客户端,返回 JSON 数据行、不写报告,按调用次数计费。
一次调用会返回多少数据?会不会吃掉我的上下文?
列表工具默认 20 行、单页硬上限 50 行,单次响应不超过 32KB;详情工具单字段最长 4000 字。超出体积上限会返回 response_too_large 并提示缩小 limit 或 fields,不会返回半坨数据。
支持哪些客户端?
任何支持远程 MCP(Streamable HTTP)的客户端都能接,包括 Claude Desktop、Claude Code、Cursor。需要的只有两样:端点 URL 和一个 X-API-Key 请求头。
API Key 怎么拿到?
在闲鱼下单获得卡密,回到本页「卡密兑换」输入卡密即可得到 mds- 开头的 API Key。Key 只完整显示一次,请妥善保存;每张卡密只能兑换一次。
额度用完了会怎样?
当日额度用完,接口返回 429 并带上今日已用次数与上限,次日 00:00(北京时间)自动重置;体验卡另有 100 次总量,总量用完需要重新兑换新卡。失败的调用不计费,但会留日志。
会不会把整库数据拉走?
不会。账号对医学库只读,工具层没有全表导出与表结构导出能力,列表工具必须带检索条件(无条件的裸调用直接拒绝),单页最多 50 行,单次响应不超过 32KB。
数据来自哪里?
来自医药数据社自建的医药数据库:药品 7.6 万行、全球临床试验 48 万条、中国临床试验 2.6 万条、医学会议摘要 45 万条、投融资事件 1.8 万条、投资机构 2.5 万家、BD 交易 4 千条、药品专利 2.7 万条、药品销量 2016–2024 年三张表。接口只读,不写入任何数据。
接上真数据,少返工一轮
闲鱼买卡密 → 本页兑换 → 填进客户端,三步完事。
去兑换卡密