DICOM MCP サーバー

DICOM 接続テスト用のモデル コンテキスト プロトコル (MCP) サーバー。

前提条件

1. UVをインストールします（必須）：

   pip install uv

   Claude がサーバーを適切に実行するために必要なので、システム PATH でuvが使用可能であることを確認してください。

Related MCP server: Echo MCP Server

インストール

サーバーをセットアップするには、次の 2 つの方法があります。

1. 従来の設定

必要な依存関係をインストールします。

uv pip install mcp[cli]

2. MCPのインストール（推奨）

このサーバーを Claude のモデル コンテキスト プロトコルで使用するには:

mcp install server.py

これにより、DICOM 操作のためにサーバーが Claude に登録されます。

サーバーの実行

直接実行

uv run server.py

クロードを通じて

MCP 経由でインストールされると、サーバーは必要に応じて Claude によって自動的に管理されます。

デフォルトでは、サーバーは 0.0.0.0:8080 で起動します。

ノード構成

サーバーは、DICOMノード設定を保存するためにnodes.yamlファイルを使用します。これにより、以下のことが可能になります。

1. 構成されたすべてのDICOMノードを一覧表示する

2. 明示的なAEタイトル、IP、ポートの代わりにノード名を使用してC-ECHO操作を実行します。

3. C-ECHO操作に異なるローカルAEタイトルを使用する

nodes.yaml フォーマット

nodes:
  # Example node configuration
  main_pacs:
    ae_title: DESTINATION
    ip: 192.168.1.100
    port: 104
    description: "Main hospital PACS system"

local_ae_titles:
  - name: default
    ae_title: MCP_DICOM
    description: "Default AE title for MCP DICOM server"
  
  - name: pacs_gateway
    ae_title: PACS_GATEWAY
    description: "PACS Gateway AE title"

トラブルシューティング

「spawn uv ENOENT」エラーが発生した場合、通常は次のいずれかを意味します。

1. UVがインストールされていないか、PATHに存在しません

2. MCPクライアントがPython実行ファイルを見つけることができません

解決策:

1. UV が適切にインストールされ、PATH に含まれていることを確認します。

   which uv  # Should show the path to UV

2. システムからアクセス可能な Python 環境を使用していることを確認します。

   • 仮想環境を使用している場合は、それがアクティブ化されていることを確認してください

   • PythonがPATHに入っているか確認する

3. 明示的な UV パスを使用してサーバーを実行してみてください。

   /full/path/to/uv run server.py

4. ログのstderr出力をチェックしてデバッグを追加します

使用法

サーバーは、MCP インターフェイスを通じて使用できるいくつかの DICOM ツールを提供します。

DICOMノードの一覧

nodes.yaml ファイルから構成されたすべての DICOM ノードを一覧表示します。

list_dicom_nodes()

ノード名によるC-ECHO

構成のノード名を使用して C-ECHO 操作を実行します。

dicom_cecho_by_name(node_name="main_pacs", local_ae_name="default")

直接C-エコー

明示的なパラメータを使用して C-ECHO 操作を実行します。

dicom_cecho(remote_ae_title="REMOTE_AE", ip="192.168.1.100", port=104, local_ae_title="MCP_DICOM")