loading…
Search for a command to run...
loading…
Recommends the most relevant MCP servers based on the client's query by searching this README file.
Recommends the most relevant MCP servers based on the client's query by searching this README file.
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]
search_mcp_servers(query, category), get_mcp_server_categories()mcp://servers/list, mcp://servers/categoriespip 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
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Or with pip
pip install uv
uv venv
source .venv/bin/activate
uv pip install search-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 optionsuse --sse when you want other apps to connect over HTTP; omit it to run in stdio mode where the client must start the process.
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.
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
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
uv run ruff check --fix .
uv run mypy mcp_server.py
# Run server
uv run python mcp_server.py --sse
npx @modelcontextprotocol/inspector uv run python mcp_server.py --sse
Add this to claude_desktop_config.json and restart Claude Desktop.
{
"mcpServers": {
"search-mcp-server": {
"command": "npx",
"args": []
}
}
}