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 覆寫 API 位址。需要能連線到 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 分