DicomToolsForMCP
基于 MCP (Model Context Protocol) 的 DICOM 医学影像文件分析工具。
安装
pip install dicomtoolsformcp
MCP Server 配置
在 MCP 客户端配置文件中添加以下配置:
{
"mcpServers": {
"dicom-tools-python": {
"command": "uvx",
"args": [
"dicomtoolsformcp"
],
"env": {
"base_url": "https://your-server.com",
"name": "your_username",
"password": "your_password",
"tel": "your_phone"
}
}
}
}
环境变量说明:
base_url: 服务器基础URL(必需)name: 用户名(可选,用于自动登录)password: 密码(可选,用于自动登录)tel: 手机号(可选,用于自动登录)
工具说明
1. scan-dicom-directory
扫描指定目录下所有可读的 .dcm 文件,汇总患者数、序列数、文件数和总字节数,返回 JSON 文本。
参数:
directory_path(string): 待扫描的本地目录路径,绝对路径,必须存在且可读
2. parse-dicom-file
解析单个 DICOM 文件,提取 PatientID、PatientName、SeriesInstanceUID、SeriesDescription 等元数据,返回结构化 JSON。
参数:
file_path(string): 待解析的本地 DICOM 文件路径,需指向实际存在的 .dcm 文件
3. analyze-dicom-directory
扫描目录中的 DICOM 序列,按 series_type 选择分析流程并上传到预配置的远端分析服务,返回上传结果及访问 URL。
参数:
directory_path(string): 包含待分析 DICOM 序列的本地目录路径,必须存在且具备读取权限series_type(string): 分析流程类型,1=主动脉分析,9=二尖瓣分析
4. separate-dicom-files
按患者和序列拆分目录下的 DICOM 文件,生成新的子目录结构,并以 JSON 返回整理后的统计结果。
参数:
directory_path(string): 待整理的顶层目录路径,执行过程中会在同级创建输出目录
5. get-analysis-result
根据 study_uid 查询分析结果,如果没有分析结果,需要进行 analyze-dicom-directory 工具上传分析,返回测量结果的 URL。
参数:
study_uid(string): DICOM序列的 study_uid,用于查询分析结果
6. export-measurement-csv
导出账号下指定 StudyInstanceUID 数组的测量数值 CSV 文件,返回下载 URL。
参数:
studyInstanceUids(array): StudyInstanceUID 数组,用于导出对应的测量数值 CSV 文件
Metadata
Release files for dicomtoolsformcp 1.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| dicomtoolsformcp-1.5.0.tar.gz | 106.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dicomtoolsformcp-1.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 142.1 kB
Release files / dicomtoolsformcp-1.5.0.tar.gz
| Download URL | dicomtoolsformcp-1.5.0.tar.gz |
|---|---|
| Size | 106.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ef84cc297bc0b98c06b8eb162264e141f547b6ec169f23ca0fcdaf55f8636890
|
|
BLAKE2b-256 checksum How to use checksums |
cd0e2d207342461afc6f6cd9058f318da23e6a5a1638d3d51cfec18edcbe63ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.8
|
Release files / dicomtoolsformcp-1.5.0-py3-none-any.whl
| Download URL | dicomtoolsformcp-1.5.0-py3-none-any.whl |
|---|---|
| Size | 35.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9d88a6dd53234142310846ff1bbbaa637dea40bd4e32e115b0aa8b253c35c946
|
|
BLAKE2b-256 checksum How to use checksums |
a99496d4ec9b465da398455fcb0ca8094a50e244a6fe4450e0b26541035d0823
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.8
|
Security for dicomtoolsformcp 1.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.