NIH RePORTER

🚀 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"
      ]
    }
  }
}

搜索结果将以结构化格式返回，包含项目详细信息，包括：

• 项目标题和摘要
• 主要调查员信息
• 机构详细信息
• 资金信息
• 项目日期和状态

📚 详细文档

调试

当 MCP 在客户端（例如 Claude Desktop）中运行时，会在根文件夹中创建一个日志文件。如果遇到问题，请检查该日志文件。

开发

该项目使用以下工具和库：

• httpx 进行异步 HTTP 请求
• mcp 实现 Mission Control Protocol
• python-dotenv 管理环境变量
• uv 进行依赖管理

日志记录

日志写入项目根目录中的 mcp-nih-reporter.log 文件。默认情况下，日志级别设置为 INFO。

贡献

如果对该项目有贡献，请遵循标准的开源贡献流程，并通过拉取请求或问题提交您的更改。

📄 许可证

[此处插入许可证信息]

📞 联系方式

[此处插入联系方式]