Skip to content

Installation

Prerequisites

  • Python 3.12+
  • uv — the fast Python package & project manager

Install uv:

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

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Install Methods

No clone, no install — run the MCP server directly:

uvx --from open-agent-search oas-mcp

Install from PyPI

uv pip install open-agent-search
# or with pip:
pip install open-agent-search

After installing, two CLI commands are available:

Command Description
open-agent-search Start the HTTP API + MCP server
oas-mcp Start the standalone MCP server (stdio)

From Source

git clone https://github.com/Jayanth-MKV/open-agent-search.git
cd open-agent-search
uv sync            # installs all deps + creates .venv automatically
uv sync --dev      # include dev tools (pytest, ruff, locust)

Verify Installation

# Check the HTTP API
uv run open-agent-search
# Visit http://localhost:8000/docs for Swagger UI

# Check the MCP server
uv run oas-mcp
# The server will start in stdio mode — press Ctrl+C to exit