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

1. 创建虚拟环境：

   conda env create -f environment.yml
   conda activate xnat-mcp

1. 配置环境变量：

复制示例环境文件并添加您的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"

1. 为Claude Desktop创建MCP服务器配置：

运行以下脚本以生成必要的 claude_desktop_config.json:

  python scripts/generate_claude_config.py

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

🤝 贡献

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

📜 许可证

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