mcpField
S
SOAPNoteAPI

SOAPNoteAPI

本地服务
soapnoteapi.com健康医疗019 周前更新
代码仓库访问官网

关于 SOAPNoteAPI

SOAPNoteAPI 是面向临床人员及临床工作流程的 MCP 服务，可将转录文本或音频转换为 SOAP 病历、编码建议和就诊摘要。其工具还可列出专科、检索病历并查询音频转录任务。

主要功能

  1. 01根据转录文本生成 SOAP 病历
  2. 02建议 ICD-10 和 CPT 账单编码
  3. 03生成患者摘要和就诊摘要
  4. 04将音频转录为 SOAP 病历
  5. 05检索病历并查询音频任务

适用场景

  1. 01根据临床转录稿起草结构化病历
  2. 02生成供临床人员审核的账单编码建议
  3. 03汇总患者一段时间内的就诊记录

MCP 相关

该 MCP 服务公开 SOAPNoteAPI 工具，用于生成病历、转录音频、生成摘要、列出专科、检索病历及查询音频任务状态。除专科列表外，其他工具均需 API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "com-soapnoteapi-soapnoteapi": {
      "command": "npx",
      "args": [
        "-y",
        "soapnoteapi-mcp"
      ],
      "env": {
        "SOAPNOTEAPI_KEY": "<SOAPNOTEAPI_KEY>"
      }
    }
  }
}
启动命令npx -y soapnoteapi-mcp
需要配置的环境变量
SOAPNOTEAPI_KEY密钥SOAPNoteAPI Bearer key (snapi_sk_...). Get one at https://app.soapnoteapi.com

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmsoapnoteapi-mcp0.1.1

工具

6

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

soapnoteapi-mcp

面向 SOAPNoteAPI 的 Model Context Protocol（MCP）服务。它可让 AI Agent（Claude Desktop/Code、Cursor、Windsurf、VS Code + Copilot 等）将临床转录文本或录音转换为结构化的 SOAP 病历、ICD-10/CPT 计费代码建议、患者摘要和就诊摘要。

⚕️ 所有临床内容和计费代码均为 AI 生成的决策支持内容，使用前必须由合格的临床医生/编码员审核。HIPAA：此服务仅通过 TLS 将 PHI 传输至 API，绝不记录病历内容。

工具

工具功能API
list_specialties列出支持的专科（无需密钥）GET /v1/specialties
generate_soap_note转录文本 → SOAP 病历（可选生成计费代码、患者摘要）POST /v1/note
get_note按 noteId 获取病历GET /v1/note/{id}
summarize_visits将多次就诊整合为纵向摘要POST /v1/visit-summary
transcribe_audio_to_soap本地音频文件 → SOAP 病历（等待异步任务完成）PUT /v1/note/audio
get_audio_status轮询异步音频任务GET /v1/audio/status/{id}

设置

在 https://app.soapnoteapi.com 获取 API 密钥（免费套餐：$10 额度，前 20 份病历免费）。

Claude Desktop / Cursor（mcp.json）
{
  "mcpServers": {
    "soapnoteapi": {
      "command": "npx",
      "args": ["-y", "soapnoteapi-mcp"],
      "env": { "SOAPNOTEAPI_KEY": "snapi_sk_live_xxxxxxxx" }
    }
  }
}
Claude Code
claude mcp add soapnoteapi --env SOAPNOTEAPI_KEY=snapi_sk_live_xxxxxxxx -- npx -y soapnoteapi-mcp

环境变量

变量必需说明
SOAPNOTEAPI_KEY是（除 list_specialties 外的所有工具均需要）Bearer 密钥，格式为 snapi_sk_live_… 或 snapi_sk_test_…
SOAPNOTEAPI_BASE_URL否覆盖 API 基础地址（默认值：https://api.soapnoteapi.com）

开发

pnpm install
pnpm --filter soapnoteapi-mcp dev     # run from source (tsx)
pnpm --filter soapnoteapi-mcp build   # compile to dist/
npx @modelcontextprotocol/inspector node dist/index.js   # interactive test

发布

pnpm --filter soapnoteapi-mcp build
cd packages/mcp && npm publish        # publishes soapnoteapi-mcp to npm

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。