nccn_guidelines_mcp

🚀 🏥 NCCN指南MCP服务器

这是一个基于模型上下文协议（MCP）的服务器，可提供对美国国立综合癌症网络（NCCN）临床指南的访问，为医疗领域提供准确且可靠的指导。

🚀 快速开始

本项目遵循系统的方法来提供准确的医疗指导：

1. 🧠 问题分析：理解临床问题或场景。
2. 📋 指南检索：在NCCN索引中搜索相关指南。
3. 📄 逐页阅读：下载并从指南中提取特定页面。
4. 🎯 基于证据的响应：根据提取的内容提供答案。

⚠️ 重要提示

本系统不使用检索增强生成（RAG）以确保准确性。相反，它直接读取指南，这可能会导致在索引初始化和PDF下载/读取期间响应时间较长，但能提供更可靠、精确的医疗指导。

✨ 主要特性

• 📚 指南索引：自动获取并维护最新的NCCN指南索引。
• ⬇️ PDF下载：支持认证下载NCCN指南PDF文件。
• 📝 内容提取：从PDF文档中提取特定页面并保留布局。
• 🚀 智能缓存：索引缓存7天，以减少服务器负载。

📦 安装指南

1. 克隆仓库：

git clone https://github.com/gscfwid/NCCN_guidelines_MCP
cd NCCN_guidelines_MCP

2. 使用uv安装依赖：

uv sync

📚 详细文档

🔧 配置客户端（注意：仅支持代理，如Cursor、Cline、Claude桌面版等）

⚠️ 重要提示

Claude桌面版在运行此MCP时可能会警告上下文长度不足。

在客户端配置中添加以下内容：

使用环境变量进行配置

{
  "mcpServers": {
    "nccn-guidelines": {
      "command": "uv",
      "args": ["--directory", "<abslute_direction_of_NCCN_guidelines_MCP>", "run", "server.py"],
      "env": {
        "NCCN_USERNAME": "<your_nccn_username>",
        "NCCN_PASSWORD": "<your_nccn_password>"
      }
    }
  }
}

⚠️ 重要注意事项

• 👤 NCCN账户注册：请注意，上述提到的NCCN用户名和密码必须在NCCN官方网站上注册。
• 🚀 首次设置：首次启动MCP服务器时，需要生成NCCN指南的YAML索引。此过程需要1 - 2分钟，请在尝试使用服务器前耐心等待。
• ⏱️ 响应时间：由于采用非RAG方法以确保准确性，在指南下载和PDF读取过程中，预计响应时间会较长。

💬 提示信息

为了获得更好的响应，请在提问前将prompt.md文件中的提示添加到代理客户端的指令中。

🛠️ 可用工具

1. 📊 get_index：获取NCCN指南索引YAML文件的原始内容。
2. 📥 download_pdf：下载NCCN指南PDF文件
   • url：要下载的PDF文件的URL。
   • filename（可选）：自定义文件名。
   • username（可选）：NCCN登录用户名（默认为NCCN_USERNAME环境变量）。
   • password（可选）：NCCN登录密码（默认为NCCN_PASSWORD环境变量）。
3. 📖 extract_content：从PDF页面中提取内容
   • pdf_path：PDF文件的路径。
   • pages（可选）：以逗号分隔的页码（例如，"1,3,5 - 7"）。

💻 使用示例

以下是一些可以提出的示例问题：

1. 🔬 广泛期小细胞肺癌（ES - SCLC）有哪些可用的一线免疫治疗方案？
2. 🎯 三阴性乳腺癌的初始化疗方案是什么？
3. 🧬 神经内分泌肿瘤的免疫治疗方案有哪些？