HomeSearch & Research › TinySearch

TinySearch

Fast discovery search and self-hosted web research for MCP agents.

Python Local
★ 229 stars Last pushed 2026-09-21 License: MIT

Topics: Search & Data Extraction

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (oci)

docker run -i --rm docker.io/marcellm01/tinysearch:v0.6.5

Or add to your MCP client config:

{
  "mcpServers": {
    "tinysearch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/marcellm01/tinysearch:v0.6.5"
      ],
      "env": {
        "MCP_TRANSPORT": "<YOUR_VALUE>",
        "TINYSEARCH_CONFIG_PATH": "<YOUR_VALUE>",
        "SEARXNG_URL": "<YOUR_VALUE>",
        "TINYSEARCH_EMBEDDING_BACKEND": "<YOUR_VALUE>",
        "TINYSEARCH_EMBEDDING_MODEL": "<YOUR_VALUE>",
        "OTEL_SERVICE_NAME": "<YOUR_VALUE>",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "<YOUR_VALUE>",
        "OTEL_EXPORTER_OTLP_PROTOCOL": "<YOUR_VALUE>",
        "OTEL_EXPORTER_OTLP_HEADERS": "<YOUR_VALUE>",
        "OTEL_RESOURCE_ATTRIBUTES": "<YOUR_VALUE>",
        "OTEL_TRACES_EXPORTER": "<YOUR_VALUE>",
        "OTEL_METRICS_EXPORTER": "<YOUR_VALUE>",
        "OTEL_SDK_DISABLED": "<YOUR_VALUE>"
      }
    }
  }
}
  • MCP_TRANSPORT — MCP transport to serve: stdio (default), sse, or streamable-http.
  • TINYSEARCH_CONFIG_PATH — Path to a tinysearch_config.json inside the container, for overriding search/embedding defaults.
  • SEARXNG_URL — SearXNG search endpoint URL. Only needed if not using the bundled Compose SearXNG service.
  • TINYSEARCH_EMBEDDING_BACKEND — Embedding implementation: onnx (default) or openai_compatible.
  • TINYSEARCH_EMBEDDING_MODEL — Local ONNX preset (fast, balanced, quality) or a Hugging Face ONNX repository id.
  • OTEL_SERVICE_NAME — OpenTelemetry service.name resource attribute; defaults to tinysearch.
  • OTEL_EXPORTER_OTLP_ENDPOINT — Common OTLP endpoint for optional TinySearch traces and metrics.
  • OTEL_EXPORTER_OTLP_PROTOCOL — OTLP transport: http/protobuf (default) or grpc.
  • OTEL_EXPORTER_OTLP_HEADERS secret — Optional authentication or routing headers for the OTLP exporter.
  • OTEL_RESOURCE_ATTRIBUTES — Additional standard OpenTelemetry resource attributes.
  • OTEL_TRACES_EXPORTER — Set to otlp to enable traces explicitly or none to disable them.
  • OTEL_METRICS_EXPORTER — Set to otlp to enable metrics explicitly or none to disable them.
  • OTEL_SDK_DISABLED — Set true to disable all OpenTelemetry signals.

Package (pypi 0.6.5)

uvx tinysuite-search

Or add to your MCP client config:

{
  "mcpServers": {
    "tinysearch": {
      "command": "uvx",
      "args": [
        "tinysuite-search"
      ]
    }
  }
}

This repository has 2 servers listed in the Official MCP Registry.

Other names: io.github.MarcellM01/tinysearch

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry