SOAPNoteAPI

soapnoteapi-mcp

Model Context Protocol（MCP）サーバーです。SOAPNoteAPI 向けに提供しています。AI エージェント（Claude Desktop/Code、Cursor、Windsurf、VS Code + Copilot など）を使って、診療記録の文字起こしや音声録音から、構造化されたSOAP ノート、ICD-10/CPT 請求コードの候補、患者サマリー、診療サマリーを作成できます。

⚕️ 臨床コンテンツと請求コードはすべてAI が生成する意思決定支援情報であり、使用前に資格を有する臨床医またはコーダーが確認する必要があります。HIPAA：このサーバーは TLS 経由で API に PHI を中継するだけで、ノートの内容を記録することはありません。

ツール

ツール	内容	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 のベース URL を上書きします（デフォルト：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