Fluxinc Dicom MCP Server

🚀 DICOM MCP サーバー

DICOM 接続性テスト用の Model Context Protocol (MCP) サーバーです。このサーバーは、DICOM 関連の操作を効率的に行うために設計されています。

🚀 クイックスタート

このサーバーを使用する前に、いくつかの前提条件を満たす必要があります。また、サーバーのセットアップと実行方法について説明します。

✨ 主な機能

• DICOM 接続性テストを行うことができます。
• 複数の方法でサーバーをセットアップできます。
• DICOM ノードの構成管理が容易です。
• いくつかの DICOM ツールを提供しています。

📦 インストール

前提条件

1. UV のインストール（必須）：

   pip install uv
   

   uv がシステムの PATH に含まれていることを確認してください。これはClaude がサーバーを正しく実行するために重要です。

サーバーのセットアップ方法

1. 従来のインストール

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

uv pip install mcp[cli]

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

このサーバーをClaude の Model Context Protocol と一緒に使用するには、次のコマンドを実行します。

mcp install server.py

これにより、Claude で DICOM 操作を行うためにサーバーが自動的に登録されます。

💻 使用例

サーバーの実行

直接実行

uv run server.py

Claude 経由での実行

MCP でインストールすると、Claude が必要に応じて自動的にサーバーを管理します。サーバーはデフォルトで 0.0.0.0:8080 ポートで実行されます。

DICOM ノードの構成

サーバーは nodes.yaml ファイルを使用して DICOM ノードの構成情報を保存します。これにより、以下のことが可能になります。

1. すべての構成済み DICOM ノードをリストする
2. ノード名を使用して C-ECHO 操作を実行する
3. C-ECHO 操作に異なるローカル AE タイトルを使用する

nodes.yaml ファイルの形式

nodes:
  # サンプルノード構成
  main_pacs:
    ae_title: DESTINATION
    ip: 192.168.1.100
    port: 104
    description: "主要病院 PACS システム"

local_ae_titles:
  - name: default
    ae_title: MCP_DICOM
    description: "MCP DICOM サーバーのデフォルト AE タイトル"
  
  - name: pacs_gateway
    ae_title: PACS_GATEWAY
    description: "PACSゲートウェイ AE タイトル"

DICOM ツールの使用

DICOM ノードのリスト表示

構成ファイルに構成されているすべての 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")

🔧 技術詳細

トラブルシューティング

「spawn uv ENOENT」エラーが発生した場合、通常は以下の原因のいずれかが考えられます。

1. UV がインストールされていないか、システムの PATH に含まれていない
2. Python 実行ファイルが MCP クライアントから見つけられない

解決策

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

   which uv  # UV のパスが表示されるはず
   

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

   • 仮想環境を使用している場合は、アクティブになっていることを確認してください。
   • Python が PATH に含まれていることを確認してください。

3. UV の完全なパスを指定してサーバーを実行してみます。

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

4. ログの stderr 出力を確認して、より多くのデバッグ情報を追加します。