JackKuo666_semanticscholar-MCP-Server

JackKuo666_semanticscholar-MCP-Server

3.2

If you are the rightful owner of JackKuo666_semanticscholar-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project implements a Model Context Protocol (MCP) server for interacting with the Semantic Scholar API, providing tools for searching papers, retrieving paper and author details, and fetching citations and references.

๐ŸŽ“ 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+
  • ๐Ÿ“š semanticscholar Python package
  • ๐Ÿ”ง mcp Python 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 "{}"
  1. Clone this repository:

    git clone https://github.com/JackKuo666/semanticscholar-MCP-Server.git
    cd semanticscholar-mcp-server
    
  2. Install the required packages:

    pip install semanticscholar mcp
    

๐Ÿ–ฅ๏ธ Usage

  1. Start the Semantic Scholar MCP server:

    python semantic_scholar_server.py
    
  2. The server will start and listen for MCP requests.

  3. 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.