tinysearch

tinysearch is a local MCP server: Fast discovery search and self-hosted web research for MCP agents. Install it from oci as docker.io/marcellm01/tinysearch:v0.6.5.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add io-github-tinysuitehq-tinysearch -e MCP_TRANSPORT=... -e TINYSEARCH_CONFIG_PATH=... -e SEARXNG_URL=... -e TINYSEARCH_EMBEDDING_BACKEND=... -e TINYSEARCH_EMBEDDING_MODEL=... -e OTEL_SERVICE_NAME=... -e OTEL_EXPORTER_OTLP_ENDPOINT=... -e OTEL_EXPORTER_OTLP_PROTOCOL=... -e OTEL_EXPORTER_OTLP_HEADERS=... -e OTEL_RESOURCE_ATTRIBUTES=... -e OTEL_TRACES_EXPORTER=... -e OTEL_METRICS_EXPORTER=... -e OTEL_SDK_DISABLED=... -- docker run -i --rm docker.io/marcellm01/tinysearch:v0.6.5

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

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

{
  "mcpServers": {
    "io-github-tinysuitehq-tinysearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/marcellm01/tinysearch:v0.6.5"
      ],
      "env": {
        "MCP_TRANSPORT": "...",
        "TINYSEARCH_CONFIG_PATH": "...",
        "SEARXNG_URL": "...",
        "TINYSEARCH_EMBEDDING_BACKEND": "...",
        "TINYSEARCH_EMBEDDING_MODEL": "...",
        "OTEL_SERVICE_NAME": "...",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "...",
        "OTEL_EXPORTER_OTLP_PROTOCOL": "...",
        "OTEL_EXPORTER_OTLP_HEADERS": "...",
        "OTEL_RESOURCE_ATTRIBUTES": "...",
        "OTEL_TRACES_EXPORTER": "...",
        "OTEL_METRICS_EXPORTER": "...",
        "OTEL_SDK_DISABLED": "..."
      }
    }
  }
}

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, OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_RESOURCE_ATTRIBUTES, OTEL_TRACES_EXPORTER, OTEL_METRICS_EXPORTER, OTEL_SDK_DISABLED