Skip to main content
Glama
SolResearchLabs

UltraSearch MCP

by SolResearchLabs
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
TypeScript
Hybrid

UltraSearch MCP

Production-grade web research for MCP clients.

UltraSearch MCP gives Claude Desktop, VS Code, Cursor, Codex, and self-hosted MCP clients a local web research server with search, fetch, crawl, summarization, provider provenance, cache resilience, and budget guardrails.

Install paths

Claude Desktop

Best end-user path after the first GitHub Release:

  1. Download the latest ultrasearch-mcp-*.mcpb from Releases.

  2. Double-click it or drag it into Claude Desktop.

  3. Enter your own SearXNG URL or hosted provider API keys in the extension UI.

  4. Start using UltraSearch tools.

Until the release artifact exists, use the raw Claude config in examples/claude-desktop.json.

VS Code, Cursor, and Copilot

Use the prompt-based config in examples/vscode-mcp.json. It uses host input variables so API keys are not hardcoded into the file.

npm

npx -y @solresearchlabs/ultrasearch-mcp doctor

Local SearXNG only:

ULTRASEARCH_SEARXNG_URL=http://127.0.0.1:8099 npx -y @solresearchlabs/ultrasearch-mcp

Hosted fallback:

ULTRASEARCH_HOSTED_FALLBACK_ENABLED=true \
ULTRASEARCH_PROVIDER_ORDER=tinyfish,exa,parallel,brave \
ULTRASEARCH_TINYFISH_API_KEY=your_key_here \
npx -y @solresearchlabs/ultrasearch-mcp

Docker

cp examples/env.example .env
docker compose -f examples/docker-compose.minimal.yml up --build

HTTP mode has no built-in auth. Bind locally or protect it at the network layer.

Tools

  • search

  • search_and_fetch

  • search_and_summarize

  • fetch_url

  • crawl_site

  • domain_stats

  • clear_cache

Configuration

Package users bring their own keys. Keys belong in their MCP host UI, OS keychain, Docker secret store, shell environment, or local config file. Do not put secrets in this repository.

Use ULTRASEARCH_* environment variables, legacy aliases, or a JSON config file at ~/.config/ultrasearch-mcp/config.json. Environment variables win. Config strings support ${ENV_NAME} placeholders.

ultrasearch-mcp init-config > ~/.config/ultrasearch-mcp/config.json
ultrasearch-mcp doctor

Release status

This repository starts fresh from a curated source snapshot. It does not carry the development git history of the upstream fork or private deployment repo. Current stage: 0.1.2, first public release candidate after Claude Desktop runtime hardening.

Persistent plan

Read docs/one-click-release-plan.md before changing install, package, registry, or release behavior.

Contributing

Read CONTRIBUTING.md, SECURITY.md, and CODE_OF_CONDUCT.md.

License

MIT. See LICENSE and NOTICE.md.