Metadata-Version: 2.4
Name: dicomtoolsforseprate
Version: 2.0.4
Summary: 基于 MCP (Model Context Protocol) 的 DICOM 医学影像文件分析工具
Project-URL: Homepage, https://github.com/yourusername/dicom-tools-mcp
Project-URL: Repository, https://github.com/yourusername/dicom-tools-mcp
Project-URL: Issues, https://github.com/yourusername/dicom-tools-mcp/issues
Author-email: jiancong Zhang <1316795665@qq.com>
License: MIT
Keywords: dicom,mcp,medical-imaging,model-context-protocol,orthanc
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Healthcare Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: >=3.10
Requires-Dist: mcp>=0.9.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydicom>=2.4.0
Requires-Dist: pyorthanc
Requires-Dist: requests>=2.31.0
Requires-Dist: sympy
Requires-Dist: tqdm>=4.66.0
Description-Content-Type: text/markdown

# DicomToolsForMCP

`DicomToolsForMCP` 是一个基于 MCP (Model Context Protocol) 的 DICOM 医学影像文件分析与上传工具。它提供了一整套命令行工具，用于处理、分析 DICOM 文件，并将其安全地上传到兼容 MCP 的服务器。

## 功能特性

- **DICOM 文件扫描与解析**: 递归扫描指定目录，解析 DICOM 文件，并提取元数据。
- **数据映射与预处理**: 根据预定义的规则，将 DICOM 标签映射为 MCP 模型所需的数据结构。
- **安全上传**: 通过 Cookie 认证，将处理后的序列安全上传到服务器。
- **状态查询**: 实时查询已上传序列的处理状态。
- **日志记录**: 自动记录每次上传的详细信息（如 `study_uid` 和目录路径），方便后续追踪。

## 安装

您可以通过 pip 从 PyPI 安装此工具：

```bash
pip install DicomToolsForMCP
```

## 使用方法

该工具提供了一个名为 `DicomToolsForMCP` 的命令行入口。

### 1. 配置文件

在运行前，请确保您的项目根目录中包含一个 `config.json` 文件，用于配置服务器地址和认证信息。

**`config.json` 示例:**

```json
{
  "base_url": "https://your-mcp-server.com",
  "cookie": "ls=your_session_cookie_here"
}
```

### 2. 运行主程序

通过以下命令启动主程序：

```bash
DicomToolsForMCP
```

程序将引导您完成以下操作：
1.  选择要处理的 DICOM 文件目录。
2.  自动扫描、解析并上传文件。
3.  查询并显示上传结果。

## 依赖项

本项目依赖于以下 Python 包：

- `mcp>=0.9.0`
- `pydicom>=2.4.0`
- `requests>=2.31.0`
- `pydantic>=2.0.0`
- `tqdm>=4.66.0`
- `pandas`
- `pyorthanc`

所有依赖项将在安装 `DicomToolsForMCP` 时自动安装。

## 许可证

本项目采用 MIT 许可证。详情请参阅 `LICENSE` 文件。

