Yacy Mcp Server

What is YaCy MCP Server?

YaCy MCP Server is an implementation of the Model Context Protocol that provides AI tools for searching the web using the YaCy web search API. It is intended for developers and users who want to integrate YaCy search capabilities into MCP-compatible AI applications.

How to use YaCy MCP Server?

Install the package using uv sync or uv pip install -e . in the yacy-mcp directory, ensure a YaCy server is running (default at http://localhost:8090), optionally set the YACY_URL environment variable, then run python -m yacy_mcp. For AI applications like Claude Desktop, configure the MCP client with the command uvx yacy_mcp and stdio transport.

Key features of YaCy MCP Server

• Provides the yacy-search tool for web searches.
• Accepts a required query parameter.
• Supports optional max_results (default 10) and resource (local or global, default global) parameters.
• Configurable YaCy instance URL via YACY_URL environment variable.
• Uses stdio transport for MCP communication.

Use cases of YaCy MCP Server

• Enabling an AI assistant to perform web searches through a local or global YaCy peer.
• Integrating decentralized, privacy-respecting web search into MCP-powered applications.
• Searching specific YaCy networks (local or global) programmatically through AI chatbots.

FAQ from YaCy MCP Server

What is required to run this server?

You need Python with uv installed, a running YaCy server (typically on http://localhost:8090), and the yacy-mcp package installed.

How do I configure the YaCy instance URL?

Set the YACY_URL environment variable. If not set, the server defaults to http://localhost:8090.

What transport protocol does the server use?

The server uses the stdio transport as specified in the MCP configuration for AI applications.

What search parameters are available?

The yacy-search tool accepts a required query string, an optional max_results integer (default 10), and an optional resource string (local or global, default global).

How is the server configured for MCP clients?

In MCP client configuration (e.g., Claude Desktop’s settings.json), set the command to uvx yacy_mcp and optionally pass environment variables like YACY_URL.