DICOM MCP 서버

DICOM 연결 테스트를 위한 MCP(모델 컨텍스트 프로토콜) 서버.

필수 조건

1. UV 설치(필수):

   지엑스피1

   Claude가 서버를 제대로 실행하는 데 필요하므로 uv 가 시스템 PATH에 있는지 확인하세요.

Related MCP server: Echo MCP Server

설치

서버를 설정하는 방법은 두 가지가 있습니다.

1. 전통적인 설정

필요한 종속성을 설치하세요:

uv pip install mcp[cli]

2. MCP 설치 (권장)

이 서버를 Claude의 모델 컨텍스트 프로토콜과 함께 사용하려면:

mcp install server.py

이렇게 하면 DICOM 작업을 위해 서버가 Claude에 등록됩니다.

서버 실행

직접 실행

uv run server.py

클로드를 통해

MCP를 통해 설치한 후에는 필요할 때 Claude가 자동으로 서버를 관리합니다.

서버는 기본적으로 0.0.0.0:8080에서 시작됩니다.

노드 구성

서버는 nodes.yaml 파일을 사용하여 DICOM 노드 구성을 저장합니다. 이를 통해 다음 작업을 수행할 수 있습니다.

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 환경을 사용하고 있는지 확인하세요.

   • 가상 환경을 사용하는 경우 활성화되어 있는지 확인하세요.

   • PATH에 Python이 있는지 확인하세요

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