YaCy搜索工具

YaCy MCP服务器

MCP（模型上下文协议）服务器实现，提供使用YaCy网络搜索API进行搜索的AI工具。

安装

1. 确保你有 uv 安装：

pip install uv

2. 在开发模式下安装软件包：

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

或者：

cd yacy-mcp
uv pip install -e .

用法

1. 确保您的YaCy服务器正在运行（通常在http://localhost:8090)
2. 设置环境变量（可选）：

export YACY_URL=http://localhost:8090

3. 运行MCP服务器：

python -m yacy_mcp

配置

可以使用环境变量配置服务器：

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

可用工具

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

人工智能应用程序的MCP配置

要将此服务器与支持模型上下文协议（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获取并运行。

与AI应用程序集成

此MCP服务器可与支持模型上下文协议的AI应用程序一起使用，以使用YaCy搜索引擎执行网络搜索。