Dicom MCP

🚀 DICOM MCP サーバー

DICOM MCP サーバーは、Model Context Protocol (MCP) に基づくツールです。DICOM 標準に準拠した医学画像システムとの相互作用に使用されます。MCP プロトコルを通じて DICOM データの検索や操作をサポートし、DICOM インスタンスに封じ込められた PDF ドキュメントからテキストを抽出するなどの便利な機能も提供します。

🚀 クイックスタート

サーバーの起動

uvicorn dicom_mcp.server:app --reload

設定ファイルを使用した起動

config.yaml 設定ファイルを作成します。

DICOM:
  AE_Title: My DICOM Server
  Port: 11112
  Max_Workers: 4
  LogLevel: INFO
  Query_Retrieve_Capability:
    SCP: true
    SCU: false
  Storage_SCP: true
  Query_SCP: true
  Retrieve_SCP: true

その後、サーバーを起動します。

uvicorn dicom_mcp.server:app --reload --config config.yaml

✨ 主な機能

DICOM データの検索

患者の検索

patients = client.search_patients()
for patient in patients:
    print(f"Patient ID: {patient.PatientID}, Name: {patient.Name}")

検査の検索

studies = client.search_studies(patient_id="12345")
for study in studies:
    print(f"Study Instance UID: {study.StudyInstanceUID}, Modality: {study.Modality}")

シリーズの検索

series = client.search_series(study_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.1")
for series in studies:
    print(f"Series Instance UID: {series.SeriesInstanceUID}, Description: {series.SeriesDescription}")

インスタンスの検索

instances = client.search_instances(series_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.2")
for instance in instances:
    print(f"SOP Instance UID: {instance.SOPInstanceUID}")

特定のインスタンスの取得

instance = client.retrieve_instance(
    study_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.1",
    series_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.2",
    sop_instance_uid="1.2.840.10008.5.1.4.1.1.2.1.3"
)
print(instance.PixelData)

封じ込められた PDF のテキスト抽出

text = client.extract_pdf_text(
    study_instance_uid="1.2.840.10008.5.1.4.1.1.104.1.1",
    series_instance_uid="1.2.840.10008.5.1.4.1.1.104.1.2",
    sop_instance_uid="1.2.840.10008.5.1.4.1.1.104.1.3"
)
print(text)

📦 インストール

pip を使用したインストール

pip install dicom-mcp

ソースコードからのインストール

1. リポジトリをクローンします。

git clone https://github.com/yourusername/dicom-mcp.git
cd dicom-mcp

2. 仮想環境を作成してアクティブ化します。

python -m venv .venv
source .venv/bin/activate  # Windows では：.venv\Scripts\activate

3. 依存関係をインストールします。

pip install -e .

📚 ドキュメント

デフォルト設定ファイル

DICOM:
  AE_Title: My DICOM Server
  Port: 11112
  Max_Workers: 4
  LogLevel: INFO
  Query_Retrieve_Capability:
    SCP: true
    SCU: false
  Storage_SCP: true
  Query_SCP: true
  Retrieve_SCP: true

カスタム設定

config.yaml カスタム設定ファイルを作成します。

DICOM:
  AE_Title: My Custom DICOM Server
  Port: 11113
  Max_Workers: 8
  LogLevel: DEBUG
  Query_Retrieve_Capability:
    SCP: false
    SCU: true
  Storage_SCP: false
  Query_SCP: false
  Retrieve_SCP: true

その後、サーバーを起動します。

uvicorn dicom_mcp.server:app --reload --config config.yaml

🔧 開発

リポジトリのクローン

git clone https://github.com/yourusername/dicom-mcp.git
cd dicom-mcp

依存関係のインストール

pip install -r requirements.txt

開発サーバーの起動

uvicorn dicom_mcp.server:app --reload

🤝 貢献の方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。

📄 ライセンス

本プロジェクトは MIT ライセンスの下で提供されています。