Skip to main content

A Universal MCP Application: universal_mcp_serpapi

Project description

Serpapi Universal MCP Server

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

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

📁 Project Structure

.
├── src/
│   └── universal_mcp_serpapi/
│       ├── __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_serpapi-0.1.8.tar.gz (138.2 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_serpapi-0.1.8-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

Details for the file universal_mcp_serpapi-0.1.8.tar.gz.

File metadata

File hashes

Hashes for universal_mcp_serpapi-0.1.8.tar.gz
Algorithm Hash digest
SHA256 c3096f520b99702b280488227a82464bb0681e60fd751391ad18515cc3aba680
MD5 079721f81ff4ba466c61798765113867
BLAKE2b-256 fc5121456479084837d4e21a9e52c4c54d5aa700cb3a8256c713f402170e26e1

See more details on using hashes here.

File details

Details for the file universal_mcp_serpapi-0.1.8-py3-none-any.whl.

File metadata

File hashes

Hashes for universal_mcp_serpapi-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 52e45a8b6857eddb1de6860509854570da6de11de44a41b5f71f7fec84bf1809
MD5 b8311443c07aa455603e6c57ac727505
BLAKE2b-256 62259299a55b052b0ccfd2a7d46f25731464bc7ef6a6382470d666f1e8ec6a07

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