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.
- π Search for papers on Semantic Scholar
- π Retrieve detailed information about specific papers
- π€ Get author details
- π Fetch citations and references for a paper
- π Python 3.10+
- π
semanticscholar
Python package - π§
mcp
Python package (Model Context Protocol)
To install semanticscholar Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli@latest install @JackKuo666/semanticscholar-mcp-server --client claude --config "{}"
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 "{}"
npx -y @smithery/cli@latest install @JackKuo666/semanticscholar-mcp-server --client windsurf --config "{}"
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
-
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
- π
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": []
}
}
}
- π
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
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.