SOAPNoteAPI

com.soapnoteapi由 soapnoteapi.com 发布v0.1.1更新于 Oct 27, 2026

Generate clinical SOAP notes, billing codes, and visit summaries from transcripts or audio.

已验证STDIO仅桌面位置与生活AI 与机器学习

概览

AI 生成的概览

通过 SOAPNoteAPI 服务把临床转录文本或音频转成结构化 SOAP 病历、计费编码建议和就诊摘要。

可以做什么
  • 列出支持的医学专科
  • 根据转录文本生成 SOAP 病历，可选附带计费编码和患者摘要
  • 按 ID 获取已生成的病历
  • 把多次就诊整合为纵向摘要
  • 把本地音频文件转写为 SOAP 病历，并查询异步音频任务状态
适用场景
适合临床医生、病历记录人员或医疗科技开发者，希望让助手根据录音或转录内容起草结构化 SOAP 病历、ICD-10/CPT 编码建议和就诊摘要的场景。
运行要求
通过 npx 以 stdio 在本地运行，需要 Node.js。除列出专科外，所有工具都需要在 SOAPNOTEAPI_KEY 环境变量中提供 SOAPNoteAPI 密钥；可用可选的 SOAPNOTEAPI_BASE_URL 覆盖接口地址。需要能访问 SOAPNoteAPI 服务的网络，并拥有免费或付费账户。
安装前请注意
病历内容和计费编码均为 AI 生成的决策辅助，必须由合格的临床医生或编码员审核。音频和转录文本可能包含受保护的健康信息，会通过 TLS 发送到 SOAPNoteAPI 服务。密钥是可计费凭证（免费额度用完后按量付费），不要放入共享配置。病历会创建并保存在远程服务上。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SOAPNoteAPI，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

soapnoteapi-mcp

A Model Context Protocol (MCP) server for SOAPNoteAPI. It lets AI agents (Claude Desktop/Code, Cursor, Windsurf, VS Code + Copilot, etc.) turn clinical transcripts or audio recordings into structured SOAP notes, ICD-10/CPT billing-code suggestions, patient summaries, and visit summaries.

⚕️ All clinical content and billing codes are AI-generated decision support and must be reviewed by a qualified clinician/coder before use. HIPAA: this server only transits PHI to the API over TLS and never logs note content.

Tools

ToolWhat it doesAPI
list_specialtiesList supported specialties (no key needed)GET /v1/specialties
generate_soap_noteTranscript → SOAP note (+ optional billing codes, patient summary)POST /v1/note
get_noteFetch a note by noteIdGET /v1/note/{id}
summarize_visitsConsolidate visits into a longitudinal summaryPOST /v1/visit-summary
transcribe_audio_to_soapLocal audio file → SOAP note (waits for async jobs)PUT /v1/note/audio
get_audio_statusPoll an async audio jobGET /v1/audio/status/{id}

Setup

Get an API key at https://app.soapnoteapi.com (free tier: $10 credit, first 20 notes free).

Claude Desktop / Cursor (mcp.json)

json
{  "mcpServers": {    "soapnoteapi": {      "command": "npx",      "args": ["-y", "soapnoteapi-mcp"],      "env": { "SOAPNOTEAPI_KEY": "snapi_sk_live_xxxxxxxx" }    }  }}

Claude Code

bash
claude mcp add soapnoteapi --env SOAPNOTEAPI_KEY=snapi_sk_live_xxxxxxxx -- npx -y soapnoteapi-mcp

Environment variables

VariableRequiredNotes
SOAPNOTEAPI_KEYyes (for all tools except list_specialties)Bearer key, snapi_sk_live_… or snapi_sk_test_…
SOAPNOTEAPI_BASE_URLnoOverride API base (default https://api.soapnoteapi.com)

Develop

bash
pnpm installpnpm --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

Publish

bash
pnpm --filter soapnoteapi-mcp buildcd packages/mcp && npm publish        # publishes soapnoteapi-mcp to npm

License

MIT

来源：README.md，提交 2cd548b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分