MCP 文档
接入自己的 Agent · 按标准协议接入 · 免部署远程连接
快速开始
1
创建 API Key
在控制台「API Keys」页创建密钥,这是连接 MCP Server 的凭证。
2
配置 MCP Server
在 Claude Desktop / Cursor 等客户端中添加远程 Server,URL 为本站 /api/mcp 端点。
3
完成鉴权
配置 Authorization: Bearer sk-... 请求头,鉴权通过后 8 个图谱工具自动加载。
4
开始查询
在对话中用自然语言提问,Agent 会自动选择合适的图谱工具执行检索与证据回溯。
mcpServers 配置
{
"mcpServers": {
"medgraph": {
"url": "",
"headers": {
"Authorization": "Bearer sk-your-api-key"
}
}
}
}
Server URL 加载中...
Cursor 命令行添加
mcp add medgraph \
--url \
--header "Authorization: Bearer sk-your-api-key"
还没有 API Key?前往 API Key 页面创建。
支持的客户端
任何支持 Model Context Protocol 的 AI 客户端均可连接药图智能 MCP 服务,包括但不限于:
Claude Desktop
在配置文件中添加 mcpServers 远程 Server 配置。
Cursor
在 Settings → MCP 中添加远程 Server。
自建 Agent
通过 MCP SDK 连接,支持 TypeScript / Python。
其他 MCP 客户端
任何兼容 MCP Streamable HTTP 协议的客户端均可使用。
常见问题
MCP、API、Skill 应该怎么选?
简单判断:需要「自己写代码精确控制」→ 选 API;需要「让 AI 自动完成完整查询流程」(适合科研人员)→ 选 Skill;需要「通过标准协议将图谱工具集成到任意 MCP 客户端或自建 Agent」→ 选 MCP。三者共用同一套图谱能力和 API Key,可随时切换。
MCP 调用如何计费?
MCP 工具底层与 API 端点完全一致,按端点消耗积分。失败请求不扣费,相同参数的缓存命中规则与 API 相同。统一账单,可在控制台查看所有接入方式的调用记录。
需要本地部署吗?
不需要。药图智能 MCP 服务以远程 Streamable HTTP 模式运行,直接通过 URL 连接即可使用。
工具一览(8 个)
| 工具名 | 说明 | 积分消耗 |
|---|---|---|
| medgraph_search | 提交直接关系(1-hop)搜索,返回 task_id | 11 credits |
| medgraph_search_indirect | 提交多跳间接路径搜索,返回 task_id | 11 credits |
| medgraph_resolve | 实体名解析(别名/缩写 → 图谱 ID) | 11 credits |
| medgraph_status | 轮询异步任务状态,completed 后取 result_id | 1 credit |
| medgraph_details | 分页获取直接关系搜索结果详情 | 1 + 返回关系条目数 |
| medgraph_details_indirect | 分页获取多跳路径详情 | 1 + 路径总跳数之和 |
| medgraph_evidences | 取直接关系的文献证据 | 1 + 页内证据条数 × 10 |
| medgraph_evidences_indirect | 取多跳路径中单跳的证据 | 1 + 页内证据条数 × 10 |