Skip to main content

A Universal MCP Application: universal_mcp_semanticscholar

Project description

Semanticscholar Universal MCP Server

This repository contains an implementation of an Semanticscholar Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Semanticscholar's SEO and backlink analysis tools through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Semanticscholar directly from agentr.dev. Visit agentr.dev/apps and enable Semanticscholar.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_semanticscholar/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

  • Python 3.11+ (recommended)
  • uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

  1. Sync Project Dependencies

    uv sync
    

    This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

  2. Activate the Virtual Environment

    For Linux/macOS:

    source .venv/bin/activate
    

    For Windows (PowerShell):

    .venv\Scripts\Activate
    
  3. Start the MCP Inspector

    mcp dev src/universal_mcp_semanticscholar/mcp.py
    

    This will start the MCP inspector. Make note of the address and port shown in the console output.

  4. Install the Application

    mcp install src/universal_mcp_semanticscholar/mcp.py
    

📁 Project Structure

.
├── src/
│   └── universal_mcp_semanticscholar/
│       ├── __init__.py       # Package initializer
│       ├── mcp.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.


Generated with MCP CLI — Happy coding! 🚀

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

universal_mcp_semanticscholar-0.1.2.tar.gz (125.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

universal_mcp_semanticscholar-0.1.2-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file universal_mcp_semanticscholar-0.1.2.tar.gz.

File metadata

File hashes

Hashes for universal_mcp_semanticscholar-0.1.2.tar.gz
Algorithm Hash digest
SHA256 522dbe4e845efe9cd11c919fb294db6d4694ad446b7e5d02f32621667674d04d
MD5 e974d9080570256f4ee8b453ae49dcc7
BLAKE2b-256 5dd7b980462bf51840a88962948d4fbac5abf5a26255925db891e84a56ec261a

See more details on using hashes here.

File details

Details for the file universal_mcp_semanticscholar-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for universal_mcp_semanticscholar-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9dd63aa4454613ee83740f765ba25036d6e8b428506eb8eb300221c470cdeeaf
MD5 bf0afdc799d80887a21891cc92d2240d
BLAKE2b-256 ee2475159d52fe1f3c5dda6c2e2acc479f37f13b930236d18845aea9c3a52aeb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page