tinysearch

tinysearch is a local MCP server: Self-hosted web research for MCP agents. Install it from oci as docker.io/marcellm01/tinysearch:v0.4.0.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add tinysearch -e MCP_TRANSPORT=... -e TINYSEARCH_CONFIG_PATH=... -e SEARXNG_URL=... -e TINYSEARCH_EMBEDDING_BACKEND=... -e TINYSEARCH_EMBEDDING_MODEL=... -- docker run -i --rm docker.io/marcellm01/tinysearch:v0.4.0

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "tinysearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/marcellm01/tinysearch:v0.4.0"
      ],
      "env": {
        "MCP_TRANSPORT": "...",
        "TINYSEARCH_CONFIG_PATH": "...",
        "SEARXNG_URL": "...",
        "TINYSEARCH_EMBEDDING_BACKEND": "...",
        "TINYSEARCH_EMBEDDING_MODEL": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Docker or Python with uv (runs with uvx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: MCP_TRANSPORT, TINYSEARCH_CONFIG_PATH, SEARXNG_URL, TINYSEARCH_EMBEDDING_BACKEND, TINYSEARCH_EMBEDDING_MODEL