beacon

A zero-config web search MCP server for any MCP client (opencode, Claude Desktop, Cursor, etc.).

Gives your local models the ability to search the web and read page content — no API keys, no Docker, no setup beyond pip install.

What it gives you

Two MCP tools:

Related MCP server: mcp-ddg-research

Install

git clone <your-fork-url> beacon
cd beacon
python3 -m venv .venv
.venv/bin/pip install -e .

Register with an MCP client

opencode

Add to your opencode.json:

{
  "mcp": {
    "beacon": {
      "type": "local",
      "command": ["/absolute/path/to/beacon/.venv/bin/beacon-mcp"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "beacon": {
      "command": "/absolute/path/to/beacon/.venv/bin/beacon-mcp"
    }
  }
}

Manual testing (CLI)

.venv/bin/beacon search "python async patterns"
.venv/bin/beacon fetch https://example.org

Configuration (optional, via env vars)

No state is written to disk. No database. No API keys required.

Development

.venv/bin/pip install -e ".[dev]"
.venv/bin/python -m pytest -v

License

MIT.