mcpField
Y
Yacy Mcp Server

Yacy Mcp Server

Local
github.com/koostySearch0Updated 52w ago
Repository

About Yacy Mcp Server

Yacy Mcp Server connects MCP-compatible AI applications to the YaCy web search API. It provides a search tool with configurable scope and result count, and supports setting the YaCy instance URL.

Key features

  1. 01Search the web with YaCy
  2. 02Set query and result count
  3. 03Choose local or global scope
  4. 04Configure the YaCy URL via environment

Use cases

  1. 01Search web pages from an AI application
  2. 02Restrict searches to local resources
  3. 03Adjust the number of search results

MCP support

The server exposes the yacy-search tool to MCP clients over stdio, using YaCy to run web searches.

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "yacy": {
      "command": "uvx",
      "args": [
        "yacy_mcp"
      ],
      "env": {
        "YACY_URL": "<YACY_URL>"
      }
    }
  }
}
Run commanduvx yacy_mcp
Environment variables to set
YACY_URL

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiyacy_mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

YaCy MCP Server

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

Installation

  1. Make sure you have uv installed:
pip install uv
  1. Install the package in development mode:
cd yacy-mcp
uv sync  # Sync all dependencies from pyproject.toml and uv.lock

Or alternatively:

cd yacy-mcp
uv pip install -e .

Usage

  1. Make sure you have a YaCy server running (typically on http://localhost:8090)
  2. Set environment variables (optional):
export YACY_URL=http://localhost:8090
  1. Run the MCP server:
python -m yacy_mcp

Configuration

The server can be configured using environment variables:

Available Tools

  • yacy-search: Search using YaCy web search engine
    • Parameters:
      • query (string, required): Search query string
      • max_results (integer, optional): Maximum number of results to return (default: 10)
      • resource (string, optional): Search resource (local or global, default: global)

MCP Configuration for AI Applications

To use this server with AI applications that support the Model Context Protocol (MCP), configure your MCP client to connect to the server using stdio transport.

Example configuration for Claude Desktop (settings.json):

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

For other MCP-compatible applications, use the command uvx yacy_mcp as the server executable. The server will be automatically fetched and run from PyPI.

Integration with AI Applications

This MCP server can be used with AI applications that support the Model Context Protocol to perform web searches using the YaCy search engine.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.