Advertise
MCP.so
Sign In
Y

Yacy MCP Server

@koosty

Repository

Basic information

Category

Search

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

Google Search MCP Server

HasData

Hosted Google Search / SERP MCP server from HasData, no Google Cloud project. Organic results, AI Overview, People Also Ask, AI Mode, news and shopping for Claude, Cursor and any MCP client.

23

Free SEO Audit for Claude

houtini.com

Free SEO Audit MCP server for Claude - captures and stores all the raw data you need for a complete technical SEO audit. Google Search Console + a first-party crawl + DataForSEO + Majestic SEO merged into one prioritised

86

CUQU找搭子 MCP（粗趣）

cuqu-net

CUQU找搭子官方 Agent Skill：让任意 AI Agent（Claude Code/Codex/Cursor/WorkBuddy）代用户找同城线下局、报名、支付、发局。MCP Streamable HTTP + 个人 API Key 网关 agent.cuqu.net

Default Privacy

Default Privacy

Sourced privacy answers for AI assistants: how private an app or service is, private replacements for mainstream apps, privacy tool facts with sources, guides, MCP server vetting and free domain checks. Read-only, no acc

QuanticData — Web Scraping MCP Server

QuanticData

Web scraping MCP server for AI agents: scrape any page to clean Markdown, SERP search (Google, Bing, DuckDuckGo), site crawl and map, 74 ready-made collectors and residential proxies. 25 tools, pay per success.

Advertise