Yacy Mcp Server

@koosty

About Yacy Mcp Server

MCP (Model Context Protocol) Server implementation that provides AI tools to search using YaCy web search API.

#mcp #yacy #search #ai #model-context-protocol

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "yacy-mcp": {
      "command": "uvx",
      "args": [
        "yacy_mcp"
      ],
      "env": {
        "YACY_URL": "http://localhost:8090"
      }
    }
  }
}

Tools

Search using YaCy web search engine

Overview

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.

Frequently asked questions

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`.

Comments

Basic information

More Search MCP servers

Google Search Console MCP server for SEOs

AminForou

Google Search Console Insights with Claude AI for SEOs

1.1K

patent-literature-search-mcp

patsnap

A professional tool for searching Patsnap’s global patent and literature databases using natural language, semantic, or keyword queries. It supports precise filtering and retrieves bibliographic data in Markdown format.