semantic-scholar-fastmcp-mcp-server
Categories
Language:
Python
Stars:
20
Forks:
2
Semantic Scholar MCP Server
A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.
Features
-
Paper Search & Discovery
- Full-text search with advanced filtering
- Title-based paper matching
- Paper recommendations (single and multi-paper)
- Batch paper details retrieval
- Advanced search with ranking strategies
-
Citation Analysis
- Citation network exploration
- Reference tracking
- Citation context and influence analysis
-
Author Information
- Author search and profile details
- Publication history
- Batch author details retrieval
-
Advanced Features
- Complex search with multiple ranking strategies
- Customizable field selection
- Efficient batch operations
- Rate limiting compliance
- Support for both authenticated and unauthenticated access
- Graceful shutdown and error handling
- Connection pooling and resource management
System Requirements
- Python 3.8+
- FastMCP framework
- Environment variable for API key (optional)
Installation
Installing via Smithery
To install Semantic Scholar MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install semantic-scholar-fastmcp-mcp-server --client claude
Install using FastMCP:
fastmcp install semantic-scholar-server.py --name "Semantic Scholar" -e SEMANTIC_SCHOLAR_API_KEY=your-api-key
The -e SEMANTIC_SCHOLAR_API_KEY
parameter is optional. If not provided, the server will use unauthenticated access with lower rate limits.
Configuration
Environment Variables
-
SEMANTIC_SCHOLAR_API_KEY
: Your Semantic Scholar API key (optional)- Get your key from [Semantic Scholar API](https://www.semanticscholar.org/product/api)
- If not provided, the server will use unauthenticated access
Rate Limits
The server automatically adjusts to the appropriate rate limits:
With API Key:
- Search, batch and recommendation endpoints: 1 request per second
- Other endpoints: 10 requests per second
Without API Key:
- All endpoints: 100 requests per 5 minutes
- Longer timeouts for requests
Available MCP Tools
Note: All tools are aligned with the official Semantic Scholar API documentation. Please refer to the official documentation for detailed field specifications and the latest updates.
Paper Search Tools
-
paper_relevance_search
: Search for papers using relevance ranking- Supports comprehensive query parameters including year range and citation count filters
- Returns paginated results with customizable fields
-
paper_bulk_search
: Bulk paper search with sorting options- Similar to relevance search but optimized for larger result sets
- Supports sorting by citation count, publication date, etc.
-
paper_title_search
: Find papers by exact title match- Useful for finding specific papers when you know the title
- Returns detailed paper information with customizable fields
-
paper_details
: Get comprehensive details about a specific paper- Accepts various paper ID formats (S2 ID, DOI, ArXiv, etc.)
- Returns detailed paper metadata with nested field support
-
paper_batch_details
: Efficiently retrieve details for multiple papers- Accepts up to 1000 paper IDs per request
- Supports the same ID formats and fields as single paper details
Citation Tools
-
paper_citations
: Get papers that cite a specific paper-
Returns paginated list of citing papers
-
Includes citation context when available
-
Supports field customization and sorting
- `paper_references`: Get papers referenced by a specific paper
-
Returns paginated list of referenced papers
-
Includes reference context when available
-
Supports field customization and sorting
-
Author Tools
-
author_search
: Search for authors by name- Returns paginated results with customizable fields
- Includes affiliations and publication counts
-
author_details
: Get detailed information about an author- Returns comprehensive author metadata
- Includes metrics like h-index and citation counts
-
author_papers
: Get papers written by an author- Returns paginated list of author's publications
- Supports field customization and sorting
-
author_batch_details
: Get details for multiple authors- Efficiently retrieve information for up to 1000 authors
- Returns the same fields as single author details
Recommendation Tools
-
paper_recommendations_single
: Get recommendations based on a single paper- Returns similar papers based on content and citation patterns
- Supports field customization for recommended papers
-
paper_recommendations_multi
: Get recommendations based on multiple papers- Accepts positive and negative example papers
- Returns papers similar to positive examples and dissimilar to negative ones
Usage Examples
Basic Paper Search
results = await paper_relevance_search(
context,
query="machine learning",
year="2020-2024",
min_citation_count=50,
fields=["title", "abstract", "authors"]
)
Paper Recommendations
# Single paper recommendation
recommendations = await paper_recommendations_single(
context,
paper_id="649def34f8be52c8b66281af98ae884c09aef38b",
fields="title,authors,year"
)
# Multi-paper recommendation
recommendations = await paper_recommendations_multi(
context,
positive_paper_ids=["649def34f8be52c8b66281af98ae884c09aef38b", "ARXIV:2106.15928"],
negative_paper_ids=["ArXiv:1805.02262"],
fields="title,abstract,authors"
)
Batch Operations
# Get details for multiple papers
papers = await paper_batch_details(
context,
paper_ids=["649def34f8be52c8b66281af98ae884c09aef38b", "ARXIV:2106.15928"],
fields="title,authors,year,citations"
)
# Get details for multiple authors
authors = await author_batch_details(
context,
author_ids=["1741101", "1780531"],
fields="name,hIndex,citationCount,paperCount"
)
Error Handling
The server provides standardized error responses:
{
"error": {
"type": "error_type", # rate_limit, api_error, validation, timeout
"message": "Error description",
"details": {
# Additional context
"authenticated": true/false # Indicates if request was authenticated
}
}
}
Publisher info
Zongmin Yu
CS & Math Undergraduate Student @ National University of Singapore
More MCP servers built with Python
MCP server that exposes the Apollo.io API functionalities as tools
Enables IDEs like Cursor and Windsurf to analyze large codebases using Gemini's extensive context window.