Tinysuite Search MCP Server

by marcellm01io.github.MarcellM01/tinysearchv0.4.0

Self-hosted web research: SearXNG search with DuckDuckGo fallback, crawling, dense and BM25 reranking and deduplication into a cited, source-grounded prompt.

230Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Tinysuite Search MCP server

claude mcp add tinysuite-search -- uvx tinysuite-search

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "tinysuite-search": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tinysuite-search"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
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	—	yes	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.