🎓 Semantic Scholar MCP Server
This project implements a Model Context Protocol (MCP) server for interacting with the Semantic Scholar API. It provides tools for searching papers, retrieving paper and author details, and fetching citations and references.
✨ Features
- 🔍 Search for papers on Semantic Scholar
- 📄 Retrieve detailed information about specific papers
- 👤 Get author details
- 🔗 Fetch citations and references for a paper
📋 Prerequisites
- 🐍 Python 3.10+
- 📚
semanticscholarPython package - 🔧
mcpPython package (Model Context Protocol)
🚀 Installation
Installing via Smithery
To install semanticscholar Server for Claude Desktop automatically via Smithery:
claude
npx -y @smithery/cli@latest install @JackKuo666/semanticscholar-mcp-server --client claude --config "{}"
Cursor
Paste the following into Settings → Cursor Settings → MCP → Add new server:
- Mac/Linux
npx -y @smithery/cli@latest run @JackKuo666/semanticscholar-mcp-server --client cursor --config "{}"
Windsurf
npx -y @smithery/cli@latest install @JackKuo666/semanticscholar-mcp-server --client windsurf --config "{}"
CLine
npx -y @smithery/cli@latest install @JackKuo666/semanticscholar-mcp-server --client cline --config "{}"
-
Clone this repository:
git clone https://github.com/JackKuo666/semanticscholar-MCP-Server.git cd semanticscholar-mcp-server -
Install the required packages:
pip install semanticscholar mcp
🖥️ Usage
-
Start the Semantic Scholar MCP server:
python semantic_scholar_server.py -
The server will start and listen for MCP requests.
-
Use an MCP client to interact with the server and access the following tools:
- 🔍
search_semantic_scholar: Search for papers using a query string - 📄
get_semantic_scholar_paper_details: Get details of a specific paper - 👤
get_semantic_scholar_author_details: Get details of a specific author - 🔗
get_semantic_scholar_citations_and_references: Get citations and references for a paper
- 🔍
Usage with Claude Desktop
Add this configuration to your claude_desktop_config.json:
(Mac OS)
{
"mcpServers": {
"semanticscholar": {
"command": "python",
"args": ["-m", "semanticscholar_mcp_server"]
}
}
}
(Windows version):
{
"mcpServers": {
"semanticscholar": {
"command": "C:\\Users\\YOUR\\PATH\\miniconda3\\envs\\mcp_server\\python.exe",
"args": [
"D:\\code\\YOUR\\PATH\\semanticscholar-MCP-Server\\semanticscholar_server.py"
],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
Using with Cline
{
"mcpServers": {
"semanticscholar": {
"command": "bash",
"args": [
"-c",
"source /home/YOUR/PATH/.venv/bin/activate && python /home/YOUR/PATH/semanticscholar_mcp_server.py"
],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
📁 File Structure
- 📜
semantic_scholar_search.py: Contains functions for interacting with the Semantic Scholar API - 🖥️
semantic_scholar_server.py: Implements the MCP server and defines the available tools
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Metadata
Release files for semanticscholar-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| semanticscholar_mcp_server-0.1.0.tar.gz | 4.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| semanticscholar_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.9 kB
Release files / semanticscholar_mcp_server-0.1.0.tar.gz
| Download URL | semanticscholar_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 4.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ec270cfdef8fa0806691429faeb90e9dc23f0e6a10d73b63faf0e29f87359689
|
|
BLAKE2b-256 checksum How to use checksums |
6e0e917e2f647565130defdf38862389642ce2f93cfe2482c0e684d986a7ad33
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / semanticscholar_mcp_server-0.1.0-py3-none-any.whl
| Download URL | semanticscholar_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5b6b1baaf0c20ed980808dc23f86d5e158d77adfdac0066c07b96fe6755c655f
|
|
BLAKE2b-256 checksum How to use checksums |
3258745fa1a8acf9517455781b0be45bf1b2e19983d668d999c5c199834033d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for semanticscholar-mcp-server 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.