Dicom MCP Server

🚀 DICOM MCP 服務器

DICOM MCP 服務器是一個用於 DICOM 連接測試的模型上下文協議（MCP）服務器，能幫助用戶高效完成 DICOM 相關操作。

🚀 快速開始

在使用 DICOM MCP 服務器之前，需要完成一些準備工作。首先要安裝 UV，它是服務器正常運行的必要依賴。安裝完成後，可選擇傳統安裝或 MCP 安裝兩種方式設置服務器。安裝完成後，即可運行服務器進行 DICOM 操作。

✨ 主要特性

• 提供兩種安裝方式，滿足不同用戶需求。
• 支持直接執行和通過 Claude 管理服務器運行。
• 使用 nodes.yaml 文件存儲 DICOM 節點配置，方便管理和操作。
• 提供多種 DICOM 工具，可通過 MCP 接口使用。

📦 安裝指南

先決條件

安裝 UV（必需）：

pip install uv

確保 uv 已經安裝在您的系統 PATH 中，因為它對於 Claude 正確執行服務器是必要的。

安裝方式

1. 傳統安裝

安裝所需的依賴項：

uv pip install mcp[cli]

2. MCP 安裝（推薦）

要使用此服務器與 Claude 的模型上下文協議一起使用：

mcp install server.py

這將向 Claude 註冊服務器以進行 DICOM 操作。

💻 使用示例

運行服務器

直接執行

uv run server.py

通過 Claude

一旦通過 MCP 安裝，服務器將在需要時自動由 Claude 管理。服務器默認運行在 0.0.0.0:8080。

節點配置

服務器使用 nodes.yaml 文件來存儲 DICOM 節點的配置。以下是 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 節點

從 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")

🔧 技術細節

節點配置說明

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

1. 列出所有已配置的 DICOM 節點。
2. 使用節點名稱而不是明確的 AE 標題、IP 和端口執行 C-ECHO 操作。
3. 為 C-ECHO 操作使用不同的本地 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 輸出進行更多調試。