# 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 the paper 'Attention is All You Need'"*
- *"Find papers by Yoshua Bengio"*
- *"Help me create a literature review on quantum computing"*
- *"Analyze the impact of BERT paper through its citations"*
## Available Tools
| Tool | Description |
| ---------------------- | ------------------------------------ |
| `search_papers` | Search papers with advanced filters |
| `get_paper` | Get detailed paper information |
| `get_paper_citations` | Retrieve papers citing a given paper |
| `get_paper_references` | Get references from a paper |
| `search_authors` | Search for researchers |
| `get_author` | Get author profile details |
| `get_author_papers` | List papers by an author |
| `get_recommendations` | Get AI-powered paper recommendations |
| `batch_get_papers` | Fetch multiple papers efficiently |
## Advanced Features
### Resources
- `papers/{paper_id}` - Direct access to paper data
- `authors/{author_id}` - Direct access to author profiles
### AI Prompts
- `literature_review` - Generate comprehensive literature reviews
- `citation_analysis` - Analyze citation networks and impact
- `research_trend_analysis` - Identify emerging research trends
## Development
### Setup
```bash
git clone https://github.com/hy20191108/semantic-scholar-mcp.git
cd semantic-scholar-mcp
uv sync
```
### Testing
```bash
# Run tests
uv run pytest
# Test MCP server
uv run python test_simple_search.py
# Use MCP Inspector
uv run mcp dev server_standalone.py
```
### Build
```bash
uv build
```
## Architecture
Built with enterprise-grade patterns:
- **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
## 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/9b/37/1a15dbfa351a91a4b30a6fb57fe1e3d3622123c656fed15c012ad8c96d5d/semantic_scholar_mcp-0.2.2.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 the paper 'Attention is All You Need'\"*\n- *\"Find papers by Yoshua Bengio\"* \n- *\"Help me create a literature review on quantum computing\"*\n- *\"Analyze the impact of BERT paper through its citations\"*\n\n## Available Tools\n\n| Tool | Description |\n| ---------------------- | ------------------------------------ |\n| `search_papers` | Search papers with advanced filters |\n| `get_paper` | Get detailed paper information |\n| `get_paper_citations` | Retrieve papers citing a given paper |\n| `get_paper_references` | Get references from a paper |\n| `search_authors` | Search for researchers |\n| `get_author` | Get author profile details |\n| `get_author_papers` | List papers by an author |\n| `get_recommendations` | Get AI-powered paper recommendations |\n| `batch_get_papers` | Fetch multiple papers efficiently |\n\n## Advanced Features\n\n### Resources\n- `papers/{paper_id}` - Direct access to paper data\n- `authors/{author_id}` - Direct access to author profiles\n\n### AI Prompts\n- `literature_review` - Generate comprehensive literature reviews\n- `citation_analysis` - Analyze citation networks and impact\n- `research_trend_analysis` - Identify emerging research trends\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 tests\nuv run pytest\n\n# Test MCP server\nuv run python test_simple_search.py\n\n# Use MCP Inspector\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- **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\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",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP server for Semantic Scholar API integration with Claude Desktop",
"version": "0.2.2",
"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": "d2ed375b6afe4179f7728cafa437a801d056fbb9eaf50141ee335c98fca2c022",
"md5": "15ce2aa0c05cb26f67c0b777af002443",
"sha256": "ecf611887fa922103cabb23223f0ed5eb344c028b4868340643e94097437da75"
},
"downloads": -1,
"filename": "semantic_scholar_mcp-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "15ce2aa0c05cb26f67c0b777af002443",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 54010,
"upload_time": "2025-07-08T16:06:22",
"upload_time_iso_8601": "2025-07-08T16:06:22.127233Z",
"url": "https://files.pythonhosted.org/packages/d2/ed/375b6afe4179f7728cafa437a801d056fbb9eaf50141ee335c98fca2c022/semantic_scholar_mcp-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9b371a15dbfa351a91a4b30a6fb57fe1e3d3622123c656fed15c012ad8c96d5d",
"md5": "51c511a19aee69efd9fc7bfecc193028",
"sha256": "3ce76c6718521afcd9b1412e9f2b353eebffa44a279ac11fd11e3d108f4055af"
},
"downloads": -1,
"filename": "semantic_scholar_mcp-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "51c511a19aee69efd9fc7bfecc193028",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 245302,
"upload_time": "2025-07-08T16:06:23",
"upload_time_iso_8601": "2025-07-08T16:06:23.774208Z",
"url": "https://files.pythonhosted.org/packages/9b/37/1a15dbfa351a91a4b30a6fb57fe1e3d3622123c656fed15c012ad8c96d5d/semantic_scholar_mcp-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-08 16:06:23",
"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
