hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

DICOM MCP 서버

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

필수 조건

UV 설치(필수):지엑스피1Claude가 서버를 제대로 실행하는 데 필요하므로 uv 가 시스템 PATH에 있는지 확인하세요.

설치

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

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 노드 구성을 저장합니다. 이를 통해 다음 작업을 수행할 수 있습니다.

구성된 모든 DICOM 노드 나열
명시적인 AE 제목, IP 및 포트 대신 노드 이름을 사용하여 C-ECHO 작업 수행
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" 오류가 발생하는 경우 일반적으로 다음 중 하나를 의미합니다.

UV가 설치되지 않았거나 PATH에 없습니다.
MCP 클라이언트에서 Python 실행 파일을 찾을 수 없습니다.

해결책:

UV가 제대로 설치되었고 PATH에 있는지 확인하세요.
which uv # Should show the path to UV
시스템에서 접근 가능한 Python 환경을 사용하고 있는지 확인하세요.
- 가상 환경을 사용하는 경우 활성화되어 있는지 확인하세요.
- PATH에 Python이 있는지 확인하세요
명시적인 UV 경로로 서버를 실행해보세요.
/full/path/to/uv run server.py
로그에서 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")

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude의 모델 컨텍스트 프로토콜을 통해 DICOM 네트워크 작업(C-ECHO 등)을 가능하게 하는 연결성 테스트 서버로, 노드 구성 관리를 지원합니다.

Related Resources

Reddit Discussion about this server

DICOM MCP Server