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_id11 credits
medgraph_search_indirect提交多跳间接路径搜索,返回 task_id11 credits
medgraph_resolve实体名解析(别名/缩写 → 图谱 ID)11 credits
medgraph_status轮询异步任务状态,completed 后取 result_id1 credit
medgraph_details分页获取直接关系搜索结果详情1 + 返回关系条目数
medgraph_details_indirect分页获取多跳路径详情1 + 路径总跳数之和
medgraph_evidences取直接关系的文献证据1 + 页内证据条数 × 10
medgraph_evidences_indirect取多跳路径中单跳的证据1 + 页内证据条数 × 10

计费规则详见 计费规则;在线试用请前往 体验中心。