AI导哈

研究代理MCP服务

一个集成OpenAlex API和MongoDB的研究代理服务，用于高效检索高影响力学术论文并结构化存储研究结果。

  • by gokuno1
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gokuno1/research-agent-mcp

使用说明

研究代理MCP:OpenAlex+光标技能设置

该项目包括：

  • 本地OpenAlex MCP服务器(mcp-openalex/mcp-openalex)
  • 结构化研究运行的项目技能(.cursor/skills/openalex-high-impact-research/SKILL.md)
  • MongoDB MCP集成，用于存储运行输出 research_agent.research_runs

在Cursor IDE中进行首次设置时，请使用本指南。

1） 先决条件

  • 启用MCP支持的游标IDE
  • Node.js 18+（适用于OpenAlex MCP服务器）
  • MongoDB在本地运行（默认： mongodb://127.0.0.1:27017)
  • 来自的OpenAlex API密钥 OpenAlex设置

可选但推荐：

  • OPENALEX_MAILTO 设置为您的电子邮件以进行OpenAlex请求标识

2） 设置OpenAlex MCP服务器

从项目文件夹中：

cd "D:\Projects\research-agent-mcp\mcp-openalex\mcp-openalex"
npm install
npm run build

这将创建服务器入口点：

  • D:/Projects/research-agent-mcp/mcp-openalex/mcp-openalex/dist/src/index.js

3） 在游标中配置OpenAlex MCP

在光标MCP设置中，添加一个MCP服务器条目，如下所示：

{
  "OpenAlex_Research_1_0_0": {
    "command": "node",
    "args": [
      "D:/Projects/research-agent-mcp/mcp-openalex/mcp-openalex/dist/src/index.js"
    ],
    "env": {
      "OPENALEX_API_KEY": "YOUR_OPENALEX_API_KEY",
      "OPENALEX_MAILTO": "you@example.com"
    }
  }
}

然后重新启动Cursor（或重新加载MCP服务器）。

4） 为本地数据库配置MongoDB MCP

此项目已在中启用了MongoDB插件 .cursor/settings.json.

要将MongoDB MCP连接到本地MongoDB，请设置MCP环境变量：

  • MDB_MCP_CONNECTION_STRING=mongodb://127.0.0.1:27017

如果你的MongoDB使用auth，请使用：

  • mongodb://USERNAME:PASSWORD@127.0.0.1:27017/?authSource=admin

可选安全模式：

  • MDB_MCP_READ_ONLY=true （防止写入操作）

更改环境变量后重新启动Cursor（或重新加载MCP服务器）。

5） 在Cursor聊天中验证MCP设置

快速验证提示：

  • List all databases from local mongo db
  • Search OpenAlex works for "event-driven architecture latency" with cited_by_count > 100

预期：

  • MongoDB MCP可以列出您的本地数据库
  • OpenAlex MCP返回工作记录（标题/id/年份/引用）

6） 运用项目研究技能

技能位置：

  • .cursor/skills/openalex-high-impact-research/SKILL.md

可靠的调用提示：

  • Run the openalex-high-impact-research skill for this question: <your question>
  • Use the project research workflow: OpenAlex high-impact retrieve -> claims -> hypotheses -> contradictions -> score -> structural fixes -> save to research_agent.research_runs.

该技能的作用：

  1. 检索高影响力的OpenAlex论文（引文库+主题过滤器）
  2. 应用域意图过滤以减少不相关的域
  3. 构建主张、假设、矛盾和质量分数
  4. 将一个运行文档保存到MongoDB：
    • 数据库： research_agent
    • 收藏： research_runs

7） 故障排除

  • 在游标中找不到OpenAlex MCP

    • 重新检查服务器名称和绝对值 args 通往 dist/src/index.js
    • 确保 npm run build 成功完成

  • OpenAlex调用失败

    • 验证 OPENALEX_API_KEY 存在于MCP环境中
    • 更新环境后重新启动游标

  • MongoDB“先连接”错误

    • 验证 MDB_MCP_CONNECTION_STRING 设置正确
    • 确认本地MongoDB正在预期的主机/端口上运行

  • 技能不会触发

    • 在第一条消息中明确地命名它： openalex-high-impact-research
    • 确认文件存在于 .cursor/skills/openalex-high-impact-research/SKILL.md

8） 注意事项

  • 不要提交真正的API密钥或数据库凭据。
  • 仅在本地Cursor MCP环境设置中保留凭据。

相关 MCP