Advertise
MCP.so
Sign In
Y

Yacy MCP Server

@koosty

Repository

Basic information

Category

Search

Last updated

Transports

stdio

Author

koosty

Submitted by

Kustian

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

Yacy MCP Server 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"
      }
    }
  }
}

Yacy MCP Server tools

1

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.

Frequently asked questions

1

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.

2

How do I configure the YaCy instance URL?

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

3

What transport protocol does the server use?

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

4

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

5

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

More Search MCP servers

S

SlickTrip

Slicktrip LLC

Live flight, hotel and seat prices for AI assistants. Search fares and hotel rates, find the cheapest days on a calendar, check open seats on a flight, and set price-drop, seat and bucket-list alerts.

Knowra

Rex Zhang

Search papers on arXiv by research topic and exact announcement date, then read full-text paper briefs. An arXiv paper search and literature search tool for AI agents: search_papers returns titles, authors and abstracts

Desearch

Desearch-ai

AI search, X search and web search for AI agents, plus page extraction and X data tools. Bring your own Desearch API key.

1

Merit — Ukrainian Law & Registers

merit.legal

Ukrainian legislation, case law and state registers for your AI assistant. 50+ official sources and 120+ read-only tools: laws in their version on any date, Supreme Court practice, court decisions, the company register,

Fitralo

Fitralo

Search Europe's road freight carriers from your AI assistant: find carriers by route, equipment and certificates among 15,700+ checked carriers in 32 countries, in 14 languages. Read-only, no account needed for searching

Advertise