MCP For Research

🚀 学术研究MCP服务器

学术研究MCP服务器是一款强大且集成化的研究工具，它能让你通过5个强大的工具，从PubMed、Google Scholar、ArXiv和JSTOR等平台查找和分析学术研究论文。

🚀 快速开始

选项1：通过AI助手使用（最简单 - 无需设置）

如果你不熟悉技术设置，可通过以下AI助手使用本工具：

• Claude（Anthropic）
• ChatGPT（OpenAI）
• Cursor（带有AI的代码编辑器）

这些助手可利用本工具帮你查找研究论文，无需你进行任何设置。

选项2：在你的计算机上设置MCP（适用于高级用户）

此选项可让你直接在计算机上结合AI助手使用该工具，就像为你的AI助手配备了一个查找研究论文的特殊工具。

设置MCP（模型上下文协议）

MCP就像是一种“语言”，能让AI助手与你计算机上的工具进行交互。你可以将其视为安装了一个特殊应用供AI助手使用。

所需条件

• 一台计算机（Windows、Mac或Linux）
• 支持MCP的AI助手（如Claude Desktop、Cursor等）
• 基本的计算机技能（下载文件、运行程序）

逐步设置步骤

1. 下载工具

   git clone https://github.com/aringadre76/mcp-for-research.git
   cd mcp-for-research
   

2. 安装依赖项

   npm install
   

3. 构建工具

   npm run build
   

4. 配置你的AI助手

   • 在AI助手的设置中找到“MCP Servers”或“Tools”。
   • 添加一个新的MCP服务器。
   • 将命令设置为：node dist/index.js。
   • 将工作目录设置为你的项目文件夹。

5. 测试设置

   npm run test:all-tools-bash
   

✨ 主要特性

• 5个集成工具：强大的多功能工具，取代了之前的24个独立工具。
• 多源搜索：支持从PubMed、Google Scholar、ArXiv和JSTOR进行搜索。
• 用户偏好设置：可自定义搜索和显示设置。
• 内容提取：支持全文论文访问和分析。
• 引用管理：支持多种引用格式。
• 错误处理：具备强大的备用机制。

📦 安装指南

下载工具

git clone https://github.com/aringadre76/mcp-for-research.git
cd mcp-for-research

安装依赖项

npm install

构建工具

npm run build

💻 使用示例

基础用法

搜索论文

{
  "method": "tools/call",
  "params": {
    "name": "research_search",
    "arguments": {
      "query": "machine learning",
      "sources": ["pubmed", "arxiv"],
      "maxResults": 15,
      "startDate": "2020/01/01"
    }
  }
}

分析论文

{
  "method": "tools/call",
  "params": {
    "name": "paper_analysis",
    "arguments": {
      "identifier": "12345678",
      "analysisType": "complete",
      "maxQuotes": 20
    }
  }
}

获取引用

{
  "method": "tools/call",
  "params": {
    "name": "citation_manager",
    "arguments": {
      "identifier": "12345678",
      "action": "all",
      "format": "apa"
    }
  }
}

📚 详细文档

项目结构

核心组件

src/
├── index.ts                           # 主服务器入口点（集成）
├── adapters/                          # 数据源连接器
│   ├── pubmed.ts                      # PubMed API集成
│   ├── google-scholar.ts              # Google Scholar网页抓取
│   ├── google-scholar-firecrawl.ts    # Firecrawl集成
│   ├── arxiv.ts                       # ArXiv集成
│   ├── unified-search.ts              # 基本多源搜索
│   ├── enhanced-unified-search.ts     # 高级多源搜索
│   └── preference-aware-unified-search.ts # 用户偏好集成
├── preferences/                       # 用户偏好管理
│   └── user-preferences.ts            # 偏好存储和检索
└── models/                            # 数据结构和接口
    ├── paper.ts                       # 论文数据模型
    ├── search.ts                      # 搜索参数模型
    └── preferences.ts                 # 偏好模型

文档

docs/
├── README.md                          # 文档索引和概述
├── CONSOLIDATION_GUIDE.md             # 完整的集成指南
├── TOOL_CONSOLIDATION.md              # 快速工具映射参考
├── PROJECT_STRUCTURE.md               # 清晰的项目组织
├── API_REFERENCE.md                   # 完整的API文档
├── ARCHITECTURE.md                    # 技术系统设计
├── DATA_MODELS.md                     # 数据结构定义
├── DEVELOPMENT.md                     # 开发者设置指南
└── TROUBLESHOOTING.md                 # 问题解决指南

测试

tests/
├── test-preferences.js                # 偏好系统测试
├── test-all-tools-simple.sh           # Bash测试运行器（推荐）
├── test_all_tools.py                  # Python测试运行器
└── test-all-tools.js                  # JavaScript测试运行器

配置

├── package.json                       # 项目依赖项和脚本
├── tsconfig.json                      # TypeScript配置
├── .env.example                       # 环境变量模板
└── README.md                          # 本文件

可用工具

服务器提供了5个集成的MCP工具，取代了之前的24个独立工具：

1. research_search

可跨多个来源进行全面的研究论文搜索，支持高级过滤和统一结果展示。 整合内容：PubMed、Google Scholar、ArXiv和JSTOR的所有独立搜索工具 参数：查询、来源、过滤器、显示选项、排序

2. paper_analysis

获取全面的论文信息、全文以及包括引用、统计数据和研究结果的分析。 整合内容：论文检索、内容提取和分析工具 参数：标识符、分析类型、引用限制、章节长度

3. citation_manager

以多种格式生成引用，并获取引用信息，包括引用计数和相关论文。 整合内容：引用工具、引用计数和相关论文发现 参数：标识符、操作、格式、相关论文限制

4. research_preferences

管理研究偏好，包括来源优先级、搜索设置、显示选项和缓存。 整合内容：所有偏好管理工具 参数：操作、类别、各种偏好值

5. web_research

使用Firecrawl进行基于网络的研究，实现可靠的内容提取和分析。 整合内容：Firecrawl集成和网络研究工具 参数：操作、目标、选项、爬取限制

迁移到新版本

集成工具向后兼容 - 你仍然可以访问相同的功能，只是通过更少、更强大的工具实现。每个集成工具都接受参数，让你可以精确指定要执行的操作。

故障排除

常见问题

问题：工具无法启动 解决方案：确保你已先运行 npm install 和 npm run build。

问题：我的AI助手找不到工具 解决方案：检查AI助手设置中的MCP服务器路径是否正确。

问题：搜索无结果 解决方案：尝试不同的搜索词，或检查偏好设置中是否启用了相关来源。

问题：如何获取特定格式的论文？ 解决方案：使用引用工具以获取所需格式（如APA、MLA等）的论文。

开发

运行测试

npm run test:all-tools-bash

构建

npm run build

开发模式

npm run dev

贡献

我们欢迎贡献！请查看我们的贡献指南，并随时提交问题或拉取请求。

🔧 技术细节

集成方法的优势

✅ 工具数量减少80%（从24个减少到5个）
✅ 更易记忆和使用
✅ 功能更强大 - 单个调用可执行多个操作
✅ 性能更优 - 减少工具注册
✅ 维护更轻松 - 减少代码重复
✅ 接口更一致 - 参数模式相似

📄 许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。

文档

如需全面的文档、指南和技术细节，请参阅目录：

• 文档概述 - 完整的文档索引
• 集成指南 - 新方法的详细说明
• 工具参考 - 旧工具到新工具的快速映射
• API参考 - 完整的工具文档
• 项目结构 - 清晰的项目组织

支持

如果你需要帮助：

1. 查看上述故障排除部分
2. 查看 docs/ 文件夹中的文档
3. 在GitHub上提交问题
4. 查看CHANGELOG.md获取近期更新

版本历史

• v2.0.0：将24个工具集成到5个强大的工具中
• v1.4.x：之前版本，包含24个独立工具
• v1.0.x：初始版本

⚠️ 重要提示

本工具旨在易于使用，同时提供强大的研究功能。集成方法使其更易于使用，同时保留了先前版本的所有功能。