Skip to main content

A Universal MCP Application: universal_mcp_semrush

Project description

Semrush Universal MCP Server

This repository contains an implementation of an Semrush Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Semrush's tools and services 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 Semrush directly from agentr.dev. Visit agentr.dev/apps and enable Semrush.

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 Tools

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_semrush/server.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_semrush/server.py
    

📁 Project Structure

.
├── src/
│   └── universal_mcp_semrush/
│       ├── __init__.py       # Package initializer
│       ├── server.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_semrush-0.1.1.tar.gz (150.5 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_semrush-0.1.1-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

Details for the file universal_mcp_semrush-0.1.1.tar.gz.

File metadata

File hashes

Hashes for universal_mcp_semrush-0.1.1.tar.gz
Algorithm Hash digest
SHA256 559991183fbd0426e8f17d67f49a7e5b392d113ddbed504a656c4249022ec46b
MD5 cb21e49746515a48aab97e9c9fa7ad0f
BLAKE2b-256 d18a370b3e420086ce6ddc36f5256aa4d445ef54faf8fb7ad08b11e6bbeecdce

See more details on using hashes here.

File details

Details for the file universal_mcp_semrush-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for universal_mcp_semrush-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1ade42385e62db43f2c97aae7cf9742e766fd9b0f8c1bebfb50ad3655763d899
MD5 20d077af9fe489b868b429120ad4eb12
BLAKE2b-256 b8e16299d3545e638a8e20cb2683c1ccf20b837e8d93744dcb3fdf6ec00f9f81

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