DICOM MCP Server

DICOM MCP サーバー

DICOM 接続テスト用の Model Context Protocol（MCP）サーバーです。

前提条件

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

   pip install uv
   

   Claude がサーバーを正しく実行するために uv がシステムの PATH から利用できることを確認してください。

インストール

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

1. 従来のセットアップ

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

uv pip install mcp[cli]

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

Claude の Model Context Protocol でこのサーバーを使用するには、次の手順を実行します。

mcp install server.py

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

サーバーの実行

直接実行

uv run server.py

Claude 経由

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-ECHO

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

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