Y

YaCy peer-to-peer search

MCP server · by pad01g

Search Docker v1.0.0

Web search, crawling and ranking evaluation on your own YaCy peer: no API key, no central service.

View source ↗ Website ↗ Generate config for multiple servers More servers

Install

unavailable — the image reference already carries a tag

Docker
docker run -i --rm ghcr.io/pad01g/yacy-search-mcp:1.0.0

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

claude_desktop_config.json

{
  "mcpServers": {
    "yacy-search": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pad01g/yacy-search-mcp:1.0.0"
      ],
      "env": {
        "YACY_URL": "<YOUR_YACY_URL>",
        "YACY_ADMIN_PASSWORD": "<YOUR_YACY_ADMIN_PASSWORD>"
      }
    }
  }
}

Format verified against the official Claude Desktop docs ↗.

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

  • YACY_URL required — Base URL of your YaCy peer as seen from the MCP server container, e.g. http://yacy:8090 on a shared Docker network (docker run --network ...), or http://host.docker.internal:8090
  • YACY_ADMIN_USER — YaCy administrator account, needed for crawling and settings
  • YACY_ADMIN_PASSWORD secret — YaCy administrator password; without it crawl, settings and the index counts of index_status are not available
  • YACY_CRAWL_ALLOW_PRIVATE — 1 lets crawl reach loopback and private addresses (intranets); off by default
  • YACY_ALLOW_TRUST_SETTINGS — 1 lets set_ranking_setting change the trust filter settings (acceptUnverified, excludeTags); off by default

GitHub

⭐ 1 stars · 最近更新于 32 天前 · GPL-2.0 license

About this server

A peer to peer web search engine you run yourself, usable by AI agents without a search API or API key. This fork of YaCy adds stricter ranking, Chinese/Japanese/Korean search, author signatures on every document, coordinator signed trust lists and NAT traversal through a libp2p relay. Agents: MCP s…

Summary from the project README — github.com/pad01g/yacy_search_server

Distributed as Docker, listed under Search. Review our MCP security guide before granting access to real data.

Frequently asked questions

What does the YaCy peer-to-peer search MCP server do?

A peer to peer web search engine you run yourself, usable by AI agents without a search API or API key. This fork of YaCy adds stricter ranking, Chinese/Japanese/Korean search, author signatures on every document, coordinator signed trust lists and NAT traversal through a libp2p relay. Agents: MCP s

How do I install YaCy peer-to-peer search?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is YaCy peer-to-peer search free to use?

The MCP server itself is free to install. The source is public on https://github.com/pad01g/yacy_search_server. Any third-party service it calls may require its own API key and account.

Which clients support YaCy peer-to-peer search?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.

Add this badge

Publish this server? Link back with a badge on your README or site — copy either snippet.

Listed on MCPNav

Markdown

[![Listed on MCPNav](https://mcpnav.net/badge/yacy-search.svg)](https://mcpnav.net/server/yacy-search/)

HTML

<a href="https://mcpnav.net/server/yacy-search/"><img src="https://mcpnav.net/badge/yacy-search.svg" alt="Listed on MCPNav" height="20"></a>