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. 🧬 神經內分泌腫瘤的免疫治療方案有哪些？