Yacy Mcp Server

Name: Yacy Mcp Server
Author: koosty

本地服务

github.com/koosty搜索与检索052 周前更新

代码仓库

关于 Yacy Mcp Server

Yacy Mcp Server 是连接 YaCy 网络搜索 API 的 MCP 服务，供兼容 MCP 的 AI 应用执行网页搜索。它支持配置 YaCy 实例，并可指定搜索范围和结果数量。

主要功能

01通过 YaCy 搜索网页
02设置查询词与结果数量
03选择本地或全局搜索
04通过环境变量配置 YaCy 地址

适用场景

01在 AI 应用中查询网页
02将搜索限制为本地资源
03调整搜索结果数量

MCP 相关

该服务通过 stdio 传输向 MCP 客户端提供 yacy-search 工具，调用 YaCy 执行网络搜索。

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

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "yacy": {
      "command": "uvx",
      "args": [
        "yacy_mcp"
      ],
      "env": {
        "YACY_URL": "<YACY_URL>"
      }
    }
  }
}

启动命令uvx yacy_mcp

需要配置的环境变量

YACY_URL

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiyacy_mcpstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

YaCy MCP Server

MCP（Model Context Protocol）服务实现，可通过 YaCy 网络搜索 API 提供 AI 搜索工具。

安装

确保已安装 uv：

pip install uv

以开发模式安装软件包：

cd yacy-mcp
uv sync  # Sync all dependencies from pyproject.toml and uv.lock

或者：

cd yacy-mcp
uv pip install -e .

使用方法

确保 YaCy 服务正在运行（通常位于 http://localhost:8090）
设置环境变量（可选）：

export YACY_URL=http://localhost:8090

运行 MCP 服务：

python -m yacy_mcp

配置

可通过环境变量配置此服务：

YACY_URL：YaCy 实例的 URL（默认值：http://localhost:8090）

可用工具

yacy-search：使用 YaCy 网络搜索引擎进行搜索
- 参数：
  - query（字符串，必填）：搜索查询字符串
  - max_results（整数，可选）：返回结果的最大数量（默认值：10）
  - resource（字符串，可选）：搜索资源（local 或 global，默认值：global）

面向 AI 应用的 MCP 配置

要在支持 Model Context Protocol（MCP）的 AI 应用中使用此服务，请将 MCP 客户端配置为通过 stdio 传输连接到该服务。

Claude Desktop 的配置示例（settings.json）：

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

对于其他兼容 MCP 的应用，请使用命令 uvx yacy_mcp 作为服务可执行文件。服务会自动从 PyPI 获取并运行。