Search MCP Server

A Model Context Protocol (MCP) server that enables searching and discovering existing MCP servers from the official GitHub repository.

Author: Krzysztof Kućmierz
Email: [email protected]
Repository [https://github.com/krzysztofkucmierz/search-mcp-server]

Features

• Search MCP Servers: Find relevant MCP servers by name, description, or category
• Dynamic Data: Live scraping from https://github.com/modelcontextprotocol/servers
• Fast & Cached: Configurable caching (default: 6 hours) for optimal performance

Tools & Resources provided by server

• Tools: search_mcp_servers(query, category), get_mcp_server_categories()
• Resources: mcp://servers/list, mcp://servers/categories

Installation and usage - quick start

pip install uv
uv venv
source .venv/bin/activate
uv pip install search-mcp-server
search-mcp-server --sse # see available command line options in next sections

Installation and usage - details

Install uv (fast Python package manager)

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or with pip
pip install uv

uv venv
source .venv/bin/activate

Install MCP server from PyPi.org

uv pip install search-mcp-server

Start the MCP server

search-mcp-server --sse

Command Line Options

• --sse: Start in SSE mode instead of stdio mode
• --port PORT: Port for SSE mode (default: 8000)
• --cache-timeout SECONDS: Cache timeout in seconds (default: 21600 = 6 hours)
• --help: Displays available options

use --sse when you want other apps to connect over HTTP; omit it to run in stdio mode where the client must start the process.

Add MCP server to your IDE (example for VSCode)

If you run the server with --sse, point your client (or VSCode MCP extension) to the SSE URL (here it is http://127.0.0.1:8000/sse). Add the following minimal JSON to the mcp.json file:

{
    "servers": {
        "Search MCP server": { "url": "http://127.0.0.1:8000/sse", "type": "http" }
    },
    "inputs": []
}

Make sure it is in "Running" state. "Start" or "Restart" if needed.

Development

Fork the repository [https://github.com/krzysztofkucmierz/search-mcp-server]

git clone https://github.com/<your-account>/search-mcp-server.git
cd search-mcp-server
uv sync

Usage

Note: the server script mcp_server.py lives in the repo root — run it directly as shown below. If you install the package, the search-mcp-server entry point (configured in pyproject.toml) will also be available.

# SSE mode (recommended) — exposes an HTTP/SSE endpoint
uv run python mcp_server.py --sse

# Custom port and cache timeout
uv run python mcp_server.py --sse --port 8001 --cache-timeout 3600

# Stdio mode (for MCP clients that spawn the process)
uv run python mcp_server.py

Code quality tools

# Code quality
uv run ruff check --fix .
uv run mypy mcp_server.py

# Run server
uv run python mcp_server.py --sse

Debugging with MCP Inspector

npx @modelcontextprotocol/inspector uv run python mcp_server.py --sse

Links

• Model Context Protocol
• MCP Servers Repository
• FastMCP Framework