easydocforms

easydocforms-mcp

医療機関の問診票向けの MCP サーバーです。空欄の PDF 問診票一式を、ホストされたモバイル対応の入力可能なフォームに変換し、患者にリンクを渡して、入力完了後のピクセル単位で正確な PDF を取得する機能を AI エージェントに提供します。PHI がエージェントのコンテキストに入ることはありません。

EasyDocForms を基盤としています。同社のドキュメント理解パイプライン（フィールド検出、チェックボックスの意味解釈、同意事項ブロック、署名モデル）は、医療機関の問診業務で本番稼働しています。このサーバーは、easydocforms-go SDK を介して Partner API をラップします。

PHI の境界（まずお読みください）

このサーバーは、保護対象医療情報がモデルを経由しないように設計されています。

• インポートできるのは空欄のフォームのみです。 import_pdf_from_url では blank_form_attestation: true が必須で、URL を受け取ります。ドキュメントのバイトデータは受け取りません。
• get_submission が返すのはメタデータと回答数のみで、患者の回答は返しません。 回答はサーバー側に保存され、API キーで保護されます。
• get_completed_pdf_link は約10分間有効な署名付き URL を返します。 API キーを公開せずに、エージェントから人間や EMR に渡せます。ファックスと同様に取り扱ってください。
• external_ref に PHI を含めてはいけません。 これは不透明な照合 ID（受診番号または注文番号）です。

ツール

ツール	機能
import_pdf_from_url	空欄の PDF 問診票をインポートします（非同期。空欄フォームの証明が必要です）
get_import_status	テンプレートの準備ができるまでインポート状況をポーリングします
list_templates	組織で有効なフォームテンプレートを一覧表示します
create_fill_link	患者がフォームに入力するためのホスト型 URL を発行します
get_submission	提出物のメタデータと回答数を返します。回答は返しません
get_completed_pdf_link	入力完了後の PDF をダウンロードするための短期間有効な署名付き URL

インストール

go install github.com/easydocforms/easydocforms-mcp/cmd/easydocforms-mcp@latest

EasyDocForms アプリで API キーを取得してください。Settings → Integrations → Partner API（このキーは一度だけ表示されます）。

または、Docker イメージを実行します（Go ツールチェーンは不要です）。

docker run -i --rm -e EASYDOCFORMS_API_KEY=edfk_live_... ghcr.io/easydocforms/easydocforms-mcp:latest

Claude Code

claude mcp add easydocforms --env EASYDOCFORMS_API_KEY=edfk_live_... -- easydocforms-mcp

Claude Desktop（または任意の MCP クライアント）

{
  "mcpServers": {
    "easydocforms": {
      "command": "easydocforms-mcp",
      "env": { "EASYDOCFORMS_API_KEY": "edfk_live_..." }
    }
  }
}

環境変数

変数	必須	用途
EASYDOCFORMS_API_KEY	はい	edfk_live_* Partner API キー
EASYDOCFORMS_BASE_URL	いいえ	API のベース URL の上書き

試してみる

MCP Inspector を使います。

EASYDOCFORMS_API_KEY=edfk_live_... npx @modelcontextprotocol/inspector easydocforms-mcp

典型的なエージェントのセッション：「https://clinic.example.com/forms/new-patient.pdf にある問診票をインポートしてください（空欄です）。次に、受診番号 8675309 の入力リンクを発行してください。」 エージェントはインポートして状況をポーリングし、external_ref: "visit-8675309" を指定してリンクを発行し、URL を返します。患者が送信した後は、「その受診分の PDF は準備できていますか？」 → get_submission + get_completed_pdf_link。

トランスポート

stdio のみで、認証情報は環境から取得します。これはローカルで実行するサーバーに関する MCP 仕様のガイダンスに従っています。ホスト型のリモート版（Streamable HTTP + OAuth 2.1）は第2段階での提供を予定しています。

開発

go test ./... -race

ライセンス

MIT