Fluxinc Dicom MCP Server

🚀 DICOM MCP 服務器

DICOM MCP 服務器是一個用於 DICOM 連通性測試的 Model Context Protocol (MCP) 服務器，能有效助力 DICOM 相關的連通性測試工作。

🚀 快速開始

先決條件

安裝 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 端口。

✨ 主要特性

• 支持傳統和 MCP 兩種安裝方式，滿足不同用戶需求。
• 可通過 Claude 自動管理服務器運行。
• 利用 nodes.yaml 文件存儲 DICOM 節點配置信息，方便進行節點管理和操作。
• 提供多種 DICOM 工具接口，可進行節點列出、C-ECHO 等操作。

📦 安裝指南

傳統安裝

安裝所需的依賴項：

uv pip install mcp[cli]

MCP 安裝（推薦）

要使用此服務器與 Claude 的 Model Context Protocol 一起使用：

mcp install server.py

這將自動在 Claude 中註冊服務器以進行 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")

🔧 技術細節

節點配置

服務器使用一個 nodes.yaml 文件來存儲 DICOM 節點的配置信息。這使您可以：

1. 列出所有已配置的 DICOM 節點
2. 使用節點名稱而不是顯式的 AE 標題、IP 和端口進行 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 標題"

故障排除

如果遇到“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 輸出添加更多調試信息