# Semantic Scholar MCP Server
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://modelcontextprotocol.io/)
Access millions of academic papers from Semantic Scholar using the Model Context Protocol (MCP). Works with Claude Code, Claude Desktop, Cursor, VS Code, and other MCP-compatible editors.
## Features
- **Smart Search**: Search papers with filters for year, fields of study, and sorting
- **Full Paper Details**: Get abstracts, authors, citations, and references
- **Author Profiles**: Explore researcher profiles and their publications
- **Citation Network**: Analyze citation relationships and impact
- **AI-Powered**: Get paper recommendations and research insights
- **Fast & Reliable**: Built-in caching, rate limiting, and error recovery
## Installation
### One-Command Setup
**Claude Code** (recommended):
```bash
claude mcp add semantic-scholar -- uvx semantic-scholar-mcp
```
**Or run directly**:
```bash
uvx semantic-scholar-mcp
```
### Alternative Installation Methods
```bash
# Install globally with uv
uv tool install semantic-scholar-mcp
# Or with pip
pip install semantic-scholar-mcp
```
### Manual Configuration (if needed)
Basic setup:
```json
{
"mcpServers": {
"semantic-scholar": {
"command": "uvx",
"args": ["semantic-scholar-mcp"]
}
}
}
```
With API key for higher limits:
```json
{
"mcpServers": {
"semantic-scholar": {
"command": "uvx",
"args": ["semantic-scholar-mcp"],
"env": {
"SEMANTIC_SCHOLAR_API_KEY": "your-api-key-here"
}
}
}
}
```
Get your free API key at: https://www.semanticscholar.org/product/api
## Usage
Ask in natural language:
- *"Find recent papers on transformer architectures in NLP"*
- *"Show me details about paper with DOI 10.1038/nature14539"*
- *"Find papers by Yoshua Bengio from 2020 onwards"*
- *"Get recommendations based on the BERT paper"*
- *"Create a literature review on quantum computing"*
## Available Tools
### 📄 Paper Tools
| Tool | Description | Example |
| ---------------------- | ------------------------------- | -------------------------------------------------- |
| `search_papers` | Search papers with filters | *"Search for deep learning papers from 2023"* |
| `get_paper` | Get detailed paper info | *"Get full details for paper ID abc123"* |
| `get_paper_citations` | Get papers citing this paper | *"Find papers that cite the attention paper"* |
| `get_paper_references` | Get papers this paper cites | *"Show references from the BERT paper"* |
| `get_paper_authors` | Get detailed author info for paper | *"Show authors of paper abc123"* |
| `batch_get_papers` | Get multiple papers efficiently | *"Get details for papers: abc123, def456, ghi789"* |
| `bulk_search_papers` | Advanced search with filters | *"Search ML papers from 2020-2023 with 50+ citations"* |
| `search_papers_by_title` | Search by exact title match | *"Find paper with title 'Attention Is All You Need'"* |
### 👤 Author Tools
| Tool | Description | Example |
| ------------------- | -------------------------- | ------------------------------------------- |
| `search_authors` | Search for researchers | *"Find authors working on computer vision"* |
| `get_author` | Get author profile | *"Get profile for author ID 12345"* |
| `get_author_papers` | List author's publications | *"Show papers by Geoffrey Hinton"* |
| `batch_get_authors` | Get multiple authors efficiently | *"Get details for authors: 123, 456, 789"* |
### 🤖 AI Tools
| Tool | Description | Example |
| --------------------- | -------------------------------- | ------------------------------------- |
| `get_recommendations` | AI-powered paper recommendations | *"Recommend papers similar to GPT-3"* |
| `get_advanced_recommendations` | Advanced ML recommendations | *"Get recommendations from positive/negative examples"* |
### 🔍 Advanced Search Tools
| Tool | Description | Example |
| ------------------- | -------------------------- | ------------------------------------------- |
| `autocomplete_query` | Get search suggestions | *"Complete query 'machine lear...'"* |
| `search_snippets` | Search text snippets | *"Find papers mentioning 'transformer architecture'"* |
### 🧠 Semantic Analysis Tools
| Tool | Description | Example |
| ------------------- | -------------------------- | ------------------------------------------- |
| `get_paper_with_embeddings` | Get paper with vector embeddings | *"Get paper with SPECTER embeddings"* |
| `search_papers_with_embeddings` | Search with semantic vectors | *"Find semantically similar papers"* |
### 📊 Dataset Tools
| Tool | Description | Example |
| ------------------- | -------------------------- | ------------------------------------------- |
| `get_dataset_releases` | List available datasets | *"Show available dataset releases"* |
| `get_dataset_info` | Get dataset information | *"Get info for dataset release 2023-01"* |
| `get_dataset_download_links` | Get download links | *"Get download links for papers dataset"* |
| `get_incremental_dataset_updates` | Get dataset updates | *"Get updates between releases"* |
## Advanced Features
### 📚 Resources (Direct Access)
| Resource | Description | Usage |
| --------------------- | ---------------------------- | ------------------------------- |
| `papers/{paper_id}` | Direct paper data access | Auto-populated in conversations |
| `authors/{author_id}` | Direct author profile access | Auto-populated in conversations |
### 🎯 AI Prompts (Smart Templates)
| Prompt | Description | Usage |
| ------------------------- | ----------------------------------------- | -------------------------------------------------- |
| `literature_review` | Generate comprehensive literature reviews | *"Create a literature review on machine learning"* |
| `citation_analysis` | Analyze citation networks and impact | *"Analyze citations for the transformer paper"* |
| `research_trend_analysis` | Identify emerging research trends | *"Analyze trends in NLP over the last 5 years"* |
## Practical Examples
### Search and Explore
```
"Find recent papers on graph neural networks published after 2022"
"Show me the most cited papers in computer vision from 2023"
"Search for papers about attention mechanisms with more than 100 citations"
```
### Deep Analysis
```
"Get full details including citations and references for paper DOI 10.1038/nature14539"
"Show me all papers by Yann LeCun from the last 3 years"
"Find papers that cite 'Attention Is All You Need' and analyze their impact"
```
### AI-Powered Research
```
"Based on the GPT-4 paper, recommend 5 related papers I should read"
"Create a literature review covering the evolution of transformer architectures"
"Analyze citation patterns for deep learning papers in the last decade"
```
## Development
### Setup
```bash
git clone https://github.com/hy20191108/semantic-scholar-mcp.git
cd semantic-scholar-mcp
uv sync
```
### Testing
```bash
# Run all tests
uv run pytest
# Test specific functionality
uv run python test_simple_search.py
# Use MCP Inspector for debugging
uv run mcp dev server_standalone.py
```
### Build
```bash
uv build
```
## Architecture
Built with enterprise-grade patterns:
- **Complete API Coverage**: All 22 Semantic Scholar API tools implemented
- **AI-Powered Features**: 3 smart prompt templates for research assistance
- **Resilience**: Circuit breaker pattern for fault tolerance
- **Performance**: In-memory LRU caching with TTL
- **Reliability**: Exponential backoff with jitter for retries
- **Observability**: Structured logging with correlation IDs
- **Type Safety**: Full type hints with Pydantic models
- **Semantic Analysis**: SPECTER v1/v2 embeddings for similarity search
- **Advanced Filtering**: Publication types, venues, date ranges, citation counts
- **Batch Operations**: Efficient bulk processing for large datasets
- **Production Ready**: 66 tests, 32.79% coverage, comprehensive error handling
## License
MIT License - see [LICENSE](LICENSE) for details.
## Acknowledgments
- [Semantic Scholar](https://www.semanticscholar.org/) for the academic graph API
- [Anthropic](https://www.anthropic.com/) for the MCP specification
- The academic community for making research accessible
---
Built for researchers worldwide 🌍
Raw data
{
"_id": null,
"home_page": null,
"name": "semantic-scholar-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "api, claude, mcp, papers, research, semantic-scholar",
"author": null,
"author_email": "hy20191108 <zwwp9976@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/62/f6/5c3b1f5bcd14afc3adefe9e2526fc2ce634172cf08ce4bbdf74bbd572840/semantic_scholar_mcp-0.2.3.tar.gz",
"platform": null,
"description": "# Semantic Scholar MCP Server\n\n[](https://opensource.org/licenses/MIT)\n[](https://www.python.org/downloads/)\n[](https://modelcontextprotocol.io/)\n\nAccess millions of academic papers from Semantic Scholar using the Model Context Protocol (MCP). Works with Claude Code, Claude Desktop, Cursor, VS Code, and other MCP-compatible editors.\n\n## Features\n\n- **Smart Search**: Search papers with filters for year, fields of study, and sorting\n- **Full Paper Details**: Get abstracts, authors, citations, and references\n- **Author Profiles**: Explore researcher profiles and their publications\n- **Citation Network**: Analyze citation relationships and impact\n- **AI-Powered**: Get paper recommendations and research insights\n- **Fast & Reliable**: Built-in caching, rate limiting, and error recovery\n\n## Installation\n\n### One-Command Setup\n\n**Claude Code** (recommended):\n```bash\nclaude mcp add semantic-scholar -- uvx semantic-scholar-mcp\n```\n\n**Or run directly**:\n```bash\nuvx semantic-scholar-mcp\n```\n\n### Alternative Installation Methods\n\n```bash\n# Install globally with uv\nuv tool install semantic-scholar-mcp\n\n# Or with pip \npip install semantic-scholar-mcp\n```\n\n### Manual Configuration (if needed)\n\nBasic setup:\n```json\n{\n \"mcpServers\": {\n \"semantic-scholar\": {\n \"command\": \"uvx\",\n \"args\": [\"semantic-scholar-mcp\"]\n }\n }\n}\n```\n\nWith API key for higher limits:\n```json\n{\n \"mcpServers\": {\n \"semantic-scholar\": {\n \"command\": \"uvx\",\n \"args\": [\"semantic-scholar-mcp\"],\n \"env\": {\n \"SEMANTIC_SCHOLAR_API_KEY\": \"your-api-key-here\"\n }\n }\n }\n}\n```\n\nGet your free API key at: https://www.semanticscholar.org/product/api\n\n## Usage\n\nAsk in natural language:\n- *\"Find recent papers on transformer architectures in NLP\"*\n- *\"Show me details about paper with DOI 10.1038/nature14539\"*\n- *\"Find papers by Yoshua Bengio from 2020 onwards\"* \n- *\"Get recommendations based on the BERT paper\"*\n- *\"Create a literature review on quantum computing\"*\n\n## Available Tools\n\n### \ud83d\udcc4 Paper Tools\n\n| Tool | Description | Example |\n| ---------------------- | ------------------------------- | -------------------------------------------------- |\n| `search_papers` | Search papers with filters | *\"Search for deep learning papers from 2023\"* |\n| `get_paper` | Get detailed paper info | *\"Get full details for paper ID abc123\"* |\n| `get_paper_citations` | Get papers citing this paper | *\"Find papers that cite the attention paper\"* |\n| `get_paper_references` | Get papers this paper cites | *\"Show references from the BERT paper\"* |\n| `get_paper_authors` | Get detailed author info for paper | *\"Show authors of paper abc123\"* |\n| `batch_get_papers` | Get multiple papers efficiently | *\"Get details for papers: abc123, def456, ghi789\"* |\n| `bulk_search_papers` | Advanced search with filters | *\"Search ML papers from 2020-2023 with 50+ citations\"* |\n| `search_papers_by_title` | Search by exact title match | *\"Find paper with title 'Attention Is All You Need'\"* |\n\n### \ud83d\udc64 Author Tools\n\n| Tool | Description | Example |\n| ------------------- | -------------------------- | ------------------------------------------- |\n| `search_authors` | Search for researchers | *\"Find authors working on computer vision\"* |\n| `get_author` | Get author profile | *\"Get profile for author ID 12345\"* |\n| `get_author_papers` | List author's publications | *\"Show papers by Geoffrey Hinton\"* |\n| `batch_get_authors` | Get multiple authors efficiently | *\"Get details for authors: 123, 456, 789\"* |\n\n### \ud83e\udd16 AI Tools\n\n| Tool | Description | Example |\n| --------------------- | -------------------------------- | ------------------------------------- |\n| `get_recommendations` | AI-powered paper recommendations | *\"Recommend papers similar to GPT-3\"* |\n| `get_advanced_recommendations` | Advanced ML recommendations | *\"Get recommendations from positive/negative examples\"* |\n\n### \ud83d\udd0d Advanced Search Tools\n\n| Tool | Description | Example |\n| ------------------- | -------------------------- | ------------------------------------------- |\n| `autocomplete_query` | Get search suggestions | *\"Complete query 'machine lear...'\"* |\n| `search_snippets` | Search text snippets | *\"Find papers mentioning 'transformer architecture'\"* |\n\n### \ud83e\udde0 Semantic Analysis Tools\n\n| Tool | Description | Example |\n| ------------------- | -------------------------- | ------------------------------------------- |\n| `get_paper_with_embeddings` | Get paper with vector embeddings | *\"Get paper with SPECTER embeddings\"* |\n| `search_papers_with_embeddings` | Search with semantic vectors | *\"Find semantically similar papers\"* |\n\n### \ud83d\udcca Dataset Tools\n\n| Tool | Description | Example |\n| ------------------- | -------------------------- | ------------------------------------------- |\n| `get_dataset_releases` | List available datasets | *\"Show available dataset releases\"* |\n| `get_dataset_info` | Get dataset information | *\"Get info for dataset release 2023-01\"* |\n| `get_dataset_download_links` | Get download links | *\"Get download links for papers dataset\"* |\n| `get_incremental_dataset_updates` | Get dataset updates | *\"Get updates between releases\"* |\n\n## Advanced Features\n\n### \ud83d\udcda Resources (Direct Access)\n\n| Resource | Description | Usage |\n| --------------------- | ---------------------------- | ------------------------------- |\n| `papers/{paper_id}` | Direct paper data access | Auto-populated in conversations |\n| `authors/{author_id}` | Direct author profile access | Auto-populated in conversations |\n\n### \ud83c\udfaf AI Prompts (Smart Templates)\n\n| Prompt | Description | Usage |\n| ------------------------- | ----------------------------------------- | -------------------------------------------------- |\n| `literature_review` | Generate comprehensive literature reviews | *\"Create a literature review on machine learning\"* |\n| `citation_analysis` | Analyze citation networks and impact | *\"Analyze citations for the transformer paper\"* |\n| `research_trend_analysis` | Identify emerging research trends | *\"Analyze trends in NLP over the last 5 years\"* |\n\n## Practical Examples\n\n### Search and Explore\n```\n\"Find recent papers on graph neural networks published after 2022\"\n\"Show me the most cited papers in computer vision from 2023\"\n\"Search for papers about attention mechanisms with more than 100 citations\"\n```\n\n### Deep Analysis\n```\n\"Get full details including citations and references for paper DOI 10.1038/nature14539\"\n\"Show me all papers by Yann LeCun from the last 3 years\"\n\"Find papers that cite 'Attention Is All You Need' and analyze their impact\"\n```\n\n### AI-Powered Research\n```\n\"Based on the GPT-4 paper, recommend 5 related papers I should read\"\n\"Create a literature review covering the evolution of transformer architectures\"\n\"Analyze citation patterns for deep learning papers in the last decade\"\n```\n\n## Development\n\n### Setup\n\n```bash\ngit clone https://github.com/hy20191108/semantic-scholar-mcp.git\ncd semantic-scholar-mcp\nuv sync\n```\n\n### Testing\n\n```bash\n# Run all tests\nuv run pytest\n\n# Test specific functionality\nuv run python test_simple_search.py\n\n# Use MCP Inspector for debugging\nuv run mcp dev server_standalone.py\n```\n\n### Build\n\n```bash\nuv build\n```\n\n## Architecture\n\nBuilt with enterprise-grade patterns:\n- **Complete API Coverage**: All 22 Semantic Scholar API tools implemented\n- **AI-Powered Features**: 3 smart prompt templates for research assistance \n- **Resilience**: Circuit breaker pattern for fault tolerance\n- **Performance**: In-memory LRU caching with TTL\n- **Reliability**: Exponential backoff with jitter for retries\n- **Observability**: Structured logging with correlation IDs\n- **Type Safety**: Full type hints with Pydantic models\n- **Semantic Analysis**: SPECTER v1/v2 embeddings for similarity search\n- **Advanced Filtering**: Publication types, venues, date ranges, citation counts\n- **Batch Operations**: Efficient bulk processing for large datasets\n- **Production Ready**: 66 tests, 32.79% coverage, comprehensive error handling\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Acknowledgments\n\n- [Semantic Scholar](https://www.semanticscholar.org/) for the academic graph API\n- [Anthropic](https://www.anthropic.com/) for the MCP specification\n- The academic community for making research accessible\n\n---\n\nBuilt for researchers worldwide \ud83c\udf0d",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for Semantic Scholar API integration with Claude Desktop",
"version": "0.2.3",
"project_urls": {
"Bug Tracker": "https://github.com/hy20191108/semantic-scholar-mcp/issues",
"Documentation": "https://github.com/hy20191108/semantic-scholar-mcp#readme",
"Homepage": "https://github.com/hy20191108/semantic-scholar-mcp",
"Repository": "https://github.com/hy20191108/semantic-scholar-mcp"
},
"split_keywords": [
"api",
" claude",
" mcp",
" papers",
" research",
" semantic-scholar"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "073fa1729c12c7d019af944042577913cfdbb0c1f51503dc898a675156048d19",
"md5": "8c299ce9e14eacfa6299d8574b256ccc",
"sha256": "698e35fd4635f61c4b39eb06e6d8add2dc898f3823e6ac91c39e063de78ad0e6"
},
"downloads": -1,
"filename": "semantic_scholar_mcp-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8c299ce9e14eacfa6299d8574b256ccc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 77315,
"upload_time": "2025-07-19T02:26:23",
"upload_time_iso_8601": "2025-07-19T02:26:23.799195Z",
"url": "https://files.pythonhosted.org/packages/07/3f/a1729c12c7d019af944042577913cfdbb0c1f51503dc898a675156048d19/semantic_scholar_mcp-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "62f65c3b1f5bcd14afc3adefe9e2526fc2ce634172cf08ce4bbdf74bbd572840",
"md5": "0c69c0e25f38240f91f585bc5441205e",
"sha256": "c5265e0d62047feccd488d43f65de4d0496a7c612476ce2946e719b30b1e1baf"
},
"downloads": -1,
"filename": "semantic_scholar_mcp-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "0c69c0e25f38240f91f585bc5441205e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 21590257,
"upload_time": "2025-07-19T02:26:26",
"upload_time_iso_8601": "2025-07-19T02:26:26.269460Z",
"url": "https://files.pythonhosted.org/packages/62/f6/5c3b1f5bcd14afc3adefe9e2526fc2ce634172cf08ce4bbdf74bbd572840/semantic_scholar_mcp-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-19 02:26:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hy20191108",
"github_project": "semantic-scholar-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "semantic-scholar-mcp"
}
JSON
