@flexpa/mcp-fhir
[!警告] これは実験的なデモであり、本番環境での使用を目的としたものではありません。
これは、FHIRサーバーに接続するTypeScriptベースのMCPサーバーです。以下の方法でFHIRリソースとやり取りするためのコアMCP機能を提供します。
URI 経由で FHIR リソースにアクセスする
FHIRリソースの検索機能の提供
特徴
リソース
ここでの「リソース」とは、FHIR定義ではなくMCP定義を指します。MCPリソースは、モデルコンテキストプロトコル(MCP)の中核となるプリミティブであり、サーバーがクライアントが読み取り、LLMインタラクションのコンテキストとして使用できるデータとコンテンツを公開できるようにします。
fhir://URI 経由で FHIR リソースを一覧表示してアクセスするリソースはFHIR JSON形式で返されます
FHIR サーバーの CapabilityStatement で利用可能なすべての FHIR リソース タイプをサポートします。
ツール
search_fhir- FHIR リソースの検索resourceTypeとsearchParamsパラメータとして受け取りますFHIR検索結果を返す
read_fhir- 個々の FHIR リソースを読み取るuriパラメータとして受け取りますFHIRリソースをJSON形式で返します
Related MCP server: Myrcael
構成
サーバーには次の環境変数が必要です。
FHIR_BASE_URL: FHIRサーバーのベースURLFHIR_ACCESS_TOKEN: 認証用の SMART on FHIR アクセストークン
発達
依存関係をインストールします:
npm installサーバーを構築します。
npm run build自動リビルドを使用した開発の場合:
npm run watchインストール
Claude Desktop で使用するには、サーバー設定を追加します。
MacOS の場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"fhir": {
"command": "/path/to/@flexpa/mcp-fhir/build/index.js"
},
"env": {
"FHIR_BASE_URL": "<FHIR_BASE_URL>",
"FHIR_ACCESS_TOKEN": "<FHIR_ACCESS_TOKEN>"
}
}
}デバッグ
MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。パッケージスクリプトとして提供されているMCP Inspectorの使用をお勧めします。
npm run inspectorインスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。