XNAT MCP 服务器

一个开源模型上下文协议(MCP)服务器,将大型语言模型(如Claude)直接连接到XNAT医学影像数据库,支持自然语言查询和分析DICOM元数据。

  • by Ede1994
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 Ede1994/xnat-mcp-server

使用说明

XNAT MCP服务器🧠🔍

一个开源的模型上下文协议(MCP)服务器,将大型语言模型(如Claude)直接连接到您的 XNAT 医学影像数据库。

通过运行此服务器,您可以使用自然语言查询XNAT项目、发现主题、检查成像会话和分析DICOM元数据,而无需编写自定义脚本。

✨ 特性

  • 只读架构: 安全地查询XNAT,没有更改或删除医疗数据的风险。
  • 分层导航: LLM遍历项目->主题->实验->扫描的工具。
  • 元数据提取: 将DICOM标头和会话参数直接拉入LLM的上下文窗口。
  • 安全认证: 支持标准XNAT凭据和Alias令牌。

🚀 先决条件

  • Python 3.10或更高版本
  • 一个活动的XNAT实例(URL和凭据/令牌)
  • MCP兼容客户端(例如。, 克劳德桌面)

🛠️ 安装

  1. 克隆存储库:

    git clone https://github.com/Ede1994/xnat-mcp-server.git
    cd xnat-mcp-server
    
  2. 创建虚拟环境:

    conda env create -f environment.yml
    conda activate xnat-mcp
    
  3. 配置环境变量: 复制示例环境文件并添加您的XNAT详细信息:

    cp .env.example .env
    

    编辑 .env 包括:

    XNAT_BASE_URL="[https://your-xnat-instance.org](https://your-xnat-instance.org)"
    XNAT_USERNAME="your_username_or_alias_token"
    XNAT_PASSWORD="your_password_or_alias_secret"
    
  4. 为Claude Desktop创建MCP服务器配置: 运行以下脚本以生成必要的 claude_desktop_config.json:

  python scripts/generate_claude_config.py

复制生成的 claude_desktop_config.json 到您的Claude Desktop配置目录。

🤝 贡献

欢迎投稿!请阅读我们的贡献指南以开始。

📜 许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。