关于 Canvas Medical MCP by usefulapi
Canvas Medical MCP by usefulapi 是通过 Canvas FHIR R4 API 搜索和读取患者病历的托管只读服务,供需要访问 FHIR 资源的 MCP 客户端使用,无需本地安装。
主要功能
- 01搜索 FHIR 资源
- 02读取单个 FHIR 资源
- 03获取一名患者的全部数据
- 04查看 FHIR 能力声明
适用场景
- 01搜索患者病历资源
- 02读取指定 FHIR 记录
- 03获取患者可用的病历数据
- 04查看 Canvas Medical 的 FHIR 能力
MCP 相关
通过托管端点向 MCP 客户端提供只读的 Canvas Medical FHIR 搜索与读取工具。用户使用 Canvas Medical 凭据进行身份验证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://canvas-medical.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-canvas-medical https://canvas-medical.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-canvas-medical":{"type":"http","url":"https://canvas-medical.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-canvas-medical":{"type":"http","url":"https://canvas-medical.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-canvas-medical":{"type":"http","url":"https://canvas-medical.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-canvas-medical":{"serverUrl":"https://canvas-medical.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| _id | string | 否 | 通过搜索按资源 id 获取资源。 |
| date | string | 否 | FHIR 日期筛选条件,例如 "ge2026-08-01" 或 "lt2026-09-01"。前缀:eq、ne、gt、lt、ge、le。 |
| name | string | 否 | 按姓名搜索,适用于 Patient 和 Practitioner。 |
| _sort | string | 否 | 排序字段,例如 -date 表示最新优先。 |
| _count | integer | 否 | 分页大小,1-100。 |
| status | string | 否 | FHIR 状态筛选条件,例如 active、completed、cancelled。 |
| _offset | integer | 否 | 分页浏览结果时使用的偏移量。 |
| patient | string | 否 | 按 Patient id 限定为一位患者。通常最先使用的筛选条件。 |
| resource | enum | 是 | 要搜索的 FHIR 资源类型。Patient | Appointment | Condition | Observation | MedicationRequest | MedicationStatement | MedicationDispense | AllergyIntolerance | Immunization | Encounter | DocumentReference | DiagnosticReport | Procedure | CarePlan | CareTeam | Goal | Coverage | Claim | Practitioner | Organization | Location | Schedule | Slot | Task | ServiceRequest | Questionnaire | QuestionnaireResponse | Consent | Device | Specimen | RelatedPerson | Communication | DetectedIssue | Provenance | Media | Group |
| identifier | string | 否 | 按业务标识符搜索,例如 MRN。 |
详细介绍
usefulapi 提供的 Canvas Medical MCP
通过 Canvas FHIR R4 API 搜索和读取患者病历。只读。托管服务,无需本地安装。
在线端点: https://canvas-medical.usefulapi.io/mcp · 主页: https://usefulapi.io
连接
- Claude(claude.ai、Desktop):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://canvas-medical.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http canvas-medical https://canvas-medical.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"canvas-medical": {
"url": "https://canvas-medical.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Canvas Medical 凭据。
分步设置指南、凭据查找方式和常见问题解答:https://usefulapi.io/canvas-medical/
首次连接时,你需要粘贴 Canvas Medical 凭据。凭据会经过验证、按用户存储,并仅限你本人使用——配置文件中不会存放密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
canvas_search | read | 搜索 FHIR 资源 |
canvas_read | read | 读取单个 FHIR 资源 |
canvas_get_patient_everything | read | 获取单个患者的全部信息 |
canvas_get_capability_statement | read | 获取 FHIR 能力声明 |
canvas_medical_usage_status | meta | 使用情况(免费套餐用量计数) |
canvas_medical_request_feature | meta | 申请缺失的功能 |
canvas_medical_upgrade | meta | 升级到 Pro(无限*) |
canvas_medical_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告使用情况、管理订阅或提交功能申请。
定价
| 套餐 | 价格 | 限制 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro | $9/mo 或 $90/yr(免费使用 2 个月) | 无限* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 canvas_medical_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 canvas_medical_cancel_subscription 取消:Pro 将持续到已付费周期结束;当前周期不予退款;在此之前运行 canvas_medical_upgrade 可撤销取消操作。你也可以发送邮件至 [email protected]。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。