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

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 与任何 MCP 兼容的客户端一起使用，例如：

• Claude Desktop
• Cursor
• 其他支持 MCP 的工具

Example claude_desktop_config.json

{
  "mcpServers": {
	 "nih-reporter": {
	      "command": "<完全限定的路径>/uv",
	      "args": [
	        "run",
	        "--with",
	        "mcp[cli]",
	        "mcp",
	        "run",
	        "<完全限定的路径>/mcp-nih-reporter/mcp-nih-reporter.py"
	      ]
	    }
  }
}

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

• 项目标题和摘要
• 首席研究员信息
• 组织详细信息
• 资助信息
• 项目日期和状态

调试

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

开发

该项目使用：

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

日志记录

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

贡献

欢迎贡献！ 请随时提交 Pull Request。 对于重大更改，请先打开一个 issue 讨论您想要更改的内容。

1. Fork 存储库
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 文件。