Nccn Guidelines MCP

🚀 国立総合がんネットワーク（NCCN）ガイドラインMCPサーバー

このサーバーは、国立総合がんネットワーク（NCCN）の臨床ガイドラインにアクセスできる、Model Context Protocol（MCP）サーバーです。

🚀 クイックスタート

このプロジェクトは、正確な医療ガイダンスを提供するために、体系的なアプローチを採用しています。以下に、その流れを説明します。

1. 🧠 問題分析：臨床的な質問やシナリオを理解します。
2. 📋 ガイドライン検索：関連するガイドラインをNCCNインデックスから検索します。
3. 📄 ページ単位の読み取り：ガイドラインから特定のページをダウンロードし、抽出します。
4. 🎯 エビデンスベースの回答：抽出した内容に基づいて回答を提供します。

⚠️ 重要提示

このシステムは、精度を確保するためにRAG（Retrieval-Augmented Generation）を使用していません。代わりに、ガイドラインを直接読み取るため、インデックスの初期化や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の読み取りプロセス中は応答時間が長くなることが予想されます。

💬 プロンプト

より良い応答を得るために、質問する前に、エージェントクライアントの指示にファイルのプロンプトを追加してください。

🛠️ 利用可能なツール

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. 🧬 神経内分泌腫瘍の免疫療法の選択肢は何ですか？