MCP.so
登录
Y

Yacy MCP Server

@koosty

基本信息

分类

搜索

传输方式

stdio

作者

koosty

提交者

Kustian

关于 Yacy MCP Server

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

Yacy MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Yacy MCP Server 工具

1

Search using YaCy web search engine

概览

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.

常见问题

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

评论

搜索 分类下的更多 MCP 服务器