NIH RePORTER MCP

一个用于与NIH RePORTER进行对话的模型上下文协议(MCP)服务器。以对话方式搜索由NIH资助的研究项目和出版物。
相关博客文章在此。

功能

• 用各种标准搜索NIH资助的研究项目：
  • 财政年度
  • 主要研究者姓名
  • 机构详情（名称、州、城市、类型、部门）
  • 资助金额
  • COVID-19响应状态
  • 资助机制
  • 研究所/中心代码
  • RCDC术语
  • 日期范围
• 搜索与NIH项目相关的出版物
• 同时搜索项目和出版物的组合功能
• 包括摘要在内的详细项目和出版物信息
• 可配置的结果限制

前提条件

• Python 3.12或更高版本
• UV包管理器（推荐用于更快的依赖安装）

安装

1. 克隆仓库：

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

1. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

1. 使用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": "<fully qualified path to>/uv",
          "args": [
            "run",
            "--with",
            "mcp[cli]",
            "mcp",
            "run",
            "<fully qualified path to>/mcp-nih-reporter/mcp-nih-reporter.py"
          ]
        }
  }
}

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

• 项目标题和摘要
• 主要研究者信息
• 机构详情
• 资助信息
• 项目日期和状态

调试

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

开发

该项目使用：

• httpx 进行异步HTTP请求
• mcp 实现任务控制协议
• python-dotenv 管理环境变量
• uv 进行依赖管理

日志记录

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

贡献

欢迎贡献！请随时提交Pull Request。对于重大更改，请先打开一个问题讨论您希望做出的更改。

1. 分叉仓库
2. 创建您的特性分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到该分支 (git push origin feature/amazing-feature)
5. 打开Pull Request

请确保根据需要更新测试，并遵循现有的代码风格。

许可证

本项目根据MIT许可证授权 - 详见LICENSE文件了解详情。