NIH RePORTER

🚀 NIH RePORTER MCP 服務器

NIH RePORTER MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，可用於與 NIH RePORTER 進行對話式交互。藉助它，用戶能夠以對話的方式搜索 NIH 資助的研究項目和出版物。

相關博客文章可查看 此處。

✨ 主要特性

• 多樣化搜索：可使用多種標準搜索 NIH 資助的研究項目，如財政年度、主要調查員姓名、機構詳細信息（名稱、州、城市、類型、部門）、資金金額、對 COVID - 19 響應的狀態、資金機制、研究所/中心代碼、RCDC 條款、日期範圍等。
• 出版物搜索：支持搜索與 NIH 項目相關的出版物。
• 組合搜索：具備結合搜索功能，可同時搜索項目和出版物。
• 詳細信息展示：提供詳細的項目和出版物信息，包括摘要。
• 結果限制可配置：支持對搜索結果進行可配置的限制。

📦 安裝指南

先決條件

• 需要 Python 3.12 或更高版本。
• 推薦使用 UV 包管理器，以實現更快的依賴安裝。

安裝步驟

1. 克隆倉庫：

git clone <repository-url>
cd mcp-nih-reporter

2. 創建並激活虛擬環境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 上使用 `.venv\Scripts\activate`

3. 使用 UV 安裝依賴項：

uv pip install -e .

💻 使用示例

基礎用法

此 MCP 服務器通過以下工具提供對 NIH RePORTER API 的訪問：

• search_projects：搜索 NIH 資助的研究項目
• search_publications：搜索與 NIH 項目相關的出版物
• search_combined：結合搜索，用於同時搜索項目和出版物
• test_connection：測試 API 連接

您可以使用此 MCP 與任何兼容的客戶端一起使用，例如：

• Claude Desktop
• Cursor
• 其他啟用 MCP 的工具

claude_desktop_config.json 示例配置

{
  "mcpServers": {
     "nih-reporter": {
          "command": "<完全限定路徑到>/uv",
          "args": [
            "運行",
            "--with",
            "mcp[cli]",
            "mcp",
            "運行",
            "<完全限定路徑到>/mcp-nih-reporter/mcp-nih-reporter.py"
          ]
        }
  }
}

搜索結果將以結構化格式返回，包含項目詳細信息，包括：

• 項目標題和摘要
• 主要調查員信息
• 機構詳細信息
• 資金信息
• 項目日期和狀態

🔧 技術細節

開發依賴

該項目使用以下工具和庫：

• httpx 進行異步 HTTP 請求
• mcp 實現 Mission Control Protocol
• python - dotenv 管理環境變量
• uv 進行依賴管理

日誌記錄

日誌寫入項目根目錄中的 mcp - nih - reporter.log 文件。默認情況下，日誌級別設置為 INFO。

📚 詳細文檔

調試

當 MCP 在客戶端（例如 Claude Desktop）中運行時，會在根文件夾中創建一個日誌文件。如果遇到問題，請檢查該日誌文件。

開發

該項目使用多種工具和庫進行開發，具體可參考技術細節部分。

貢獻

如果對該項目有貢獻，請遵循標準的開源貢獻流程，並通過拉取請求或問題提交您的更改。

📄 許可證

[此處插入許可證信息]

聯繫方式

[此處插入聯繫方式]