Scholarly Research MCP Server

A powerful, consolidated research tool that helps you find and analyze academic research papers from PubMed, Google Scholar, ArXiv, and JSTOR through just 5 powerful tools.

What This Tool Does

This tool helps you:

Find research papers on any topic from multiple academic databases
Read full papers when available (not just abstracts)
Extract key information like quotes, statistics, and findings
Get citations in the format you need for your work
Search within papers to find specific information
Organize research with customizable preferences

Key Features

5 Consolidated Tools: Powerful, multi-functional tools instead of 24 separate ones
Multi-Source Search: PubMed, Google Scholar, ArXiv, and JSTOR
User Preferences: Customizable search and display settings
Content Extraction: Full-text paper access and analysis
Citation Management: Multiple citation format support
Error Handling: Robust fallback mechanisms

Project Structure

This tool is organized into several key components:

Core Components

src/
├── index.ts                           # Main server entry point (consolidated)
├── adapters/                          # Data source connectors
│   ├── pubmed.ts                      # PubMed API integration
│   ├── google-scholar.ts              # Google Scholar web scraping
│   ├── google-scholar-firecrawl.ts    # Firecrawl integration
│   ├── arxiv.ts                       # ArXiv integration
│   ├── unified-search.ts              # Basic multi-source search
│   ├── enhanced-unified-search.ts     # Advanced multi-source search
│   └── preference-aware-unified-search.ts # User preference integration
├── preferences/                       # User preference management
│   └── user-preferences.ts            # Preference storage and retrieval
└── models/                            # Data structures and interfaces
    ├── paper.ts                       # Paper data models
    ├── search.ts                      # Search parameter models
    └── preferences.ts                 # Preference models

Documentation

docs/
├── README.md                          # Documentation index and overview
├── CONSOLIDATION_GUIDE.md             # Complete consolidation guide
├── TOOL_CONSOLIDATION.md              # Quick tool mapping reference
├── PROJECT_STRUCTURE.md               # Clean project organization
├── API_REFERENCE.md                   # Complete API documentation
├── ARCHITECTURE.md                    # Technical system design
├── DATA_MODELS.md                     # Data structure definitions
├── DEVELOPMENT.md                     # Developer setup guide
└── TROUBLESHOOTING.md                 # Problem-solving guide

Testing

tests/
├── test-preferences.js                # Preference system tests
├── test-all-tools-simple.sh           # Bash test runner (recommended)
├── test_all_tools.py                  # Python test runner
└── test-all-tools.js                  # JavaScript test runner

Configuration

├── package.json                       # Project dependencies and scripts
├── tsconfig.json                      # TypeScript configuration
├── .env.example                       # Environment variables template
└── README.md                          # This file

Available Tools

The server provides 5 consolidated MCP tools that replace the previous 24 individual tools:

1. `research_search`

Comprehensive research paper search across multiple sources with advanced filtering and unified results.

Combines: All individual search tools from PubMed, Google Scholar, ArXiv, and JSTOR Parameters: Query, sources, filters, display options, sorting

2. `paper_analysis`

Get comprehensive paper information, full text, and analysis including quotes, statistics, and findings.

Combines: Paper retrieval, content extraction, and analysis tools Parameters: Identifier, analysis type, quote limits, section lengths

3. `citation_manager`

Generate citations in multiple formats and get citation information including counts and related papers.

Combines: Citation tools, citation counting, and related paper discovery Parameters: Identifier, action, format, related paper limits

4. `research_preferences`

Manage research preferences including source priorities, search settings, display options, and caching.

Combines: All preference management tools Parameters: Action, category, various preference values

5. `web_research`

Perform web-based research using Firecrawl for reliable content extraction and analysis.

Combines: Firecrawl integration and web research tools Parameters: Action, targets, options, crawling limits

Quick Start

Option 1: Use Through AI Assistants (Easiest - No Setup Required)

If you're not comfortable with technical setup, you can use this tool through AI assistants like:

Claude (Anthropic)
ChatGPT (OpenAI)
Cursor (Code editor with AI)

These assistants can use this tool to help you find research papers without any setup on your part.

Option 2: Set Up MCP on Your Computer (For Advanced Users)

This option lets you use the tool directly with AI assistants on your computer. It's like giving your AI assistant a special tool to find research papers.

Setting Up MCP (Model Context Protocol)

MCP is like a "language" that lets AI assistants talk to tools on your computer. Think of it like installing a special app that your AI assistant can use.

What You Need

A computer (Windows, Mac, or Linux)
An AI assistant that supports MCP (like Claude Desktop, Cursor, or others)
Basic computer skills (downloading files, running programs)

Step-by-Step Setup

Download the tool
git clone https://github.com/aringadre76/mcp-for-research.git cd mcp-for-research
Install dependencies
npm install
Build the tool
npm run build
Configure your AI assistant
- Find "MCP Servers" or "Tools" in your AI assistant's settings
- Add a new MCP server
- Set the command to: node dist/index.js
- Set the working directory to your project folder
Test the setup
npm run test:all-tools-bash

Usage Examples

Search for Papers

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

Analyze a Paper

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

Get Citations

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

Benefits of the Consolidated Approach

✅ 80% reduction in tool count (24 → 5)
✅ Easier to remember and use
✅ More powerful - multiple operations in single calls
✅ Better performance - fewer tool registrations
✅ Easier maintenance - less code duplication
✅ Consistent interface - similar parameter patterns

Migration from Previous Version

The consolidated tools are backward compatible - you can still access the same functionality, just through fewer, more powerful tools. Each consolidated tool accepts parameters that let you specify exactly what you want to do.

Old Tool	New Tool	Notes
`search_papers`	`research_search`	Use `sources: ["pubmed"]`
`get_paper_by_id`	`paper_analysis`	Use `analysisType: "basic"`
`get_full_text`	`paper_analysis`	Use `analysisType: "full-text"`
`get_citation`	`citation_manager`	Use `action: "generate"`
`set_source_preference`	`research_preferences`	Use `action: "set", category: "source"`

Troubleshooting

Common Issues

Q: The tool doesn't start A: Make sure you've run npm install and npm run build first.

Q: My AI assistant can't find the tools A: Check that the MCP server path is correct in your AI assistant's settings.

Q: Searches return no results A: Try different search terms or check if your sources are enabled in preferences.

Q: How do I get papers in a specific format? A: Use the citation tools to get the paper in the format you need (APA, MLA, etc.).

Development

Running Tests

npm run test:all-tools-bash

Building

npm run build

Development Mode

npm run dev

Contributing

We welcome contributions! Please see our contributing guidelines and feel free to submit issues or pull requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Documentation

For comprehensive documentation, guides, and technical details, see the docs/ directory:

Documentation Overview - Complete documentation index
Consolidation Guide - Detailed explanation of the new approach
Tool Reference - Quick mapping from old to new tools
API Reference - Complete tool documentation
Project Structure - Clean project organization

Support

If you need help:

Check the troubleshooting section above
Look at the documentation in the docs/ folder
Open an issue on GitHub
Check the CHANGELOG.md for recent updates

Version History

v2.0.0: Consolidated 24 tools into 5 powerful tools
v1.4.x: Previous version with 24 individual tools
v1.0.x: Initial release

Note: This tool is designed to be easy to use while providing powerful research capabilities. The consolidated approach makes it simpler to use while maintaining all the functionality of the previous version.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables comprehensive academic research by searching and analyzing papers from PubMed, Google Scholar, ArXiv, and JSTOR. Provides full-text access, citation management, and research organization through five powerful consolidated tools.

Related MCP Servers

MCP Scholarly Server
adityak74
A
security
A
license
A
quality
Enables users to search for academic articles on platforms like arXiv using specific keywords, with plans to integrate more scholarly databases in the future.
Last updated -
2
150
MIT License
Academic Paper Search MCP Server
afrise
A
security
A
license
A
quality
Enables real-time search and retrieval of academic paper information from multiple sources, providing access to paper metadata, abstracts, and full-text content when available, with structured data responses for integration with AI models that support tool/function calling.
Last updated -
3
66
AGPL 3.0
cite-mcp
ndchikin
A
security
A
license
A
quality
Retrieve citation data effortlessly from CiteAs and Google Scholar. Get BibTeX-formatted citations for your resources with just a few commands. Enhance your research workflow by integrating citation retrieval directly into your applications.
Last updated -
2
9
MIT License
PubMed Enhanced Search
leescot
-
security
F
license
-
quality
Enables search and retrieval of academic papers from PubMed database with advanced features like MeSH term lookup, publication statistics, and PICO-based evidence search.
Last updated -
5

View all related MCP servers