YaCy MCP Server

Servidor YaCy MCP

Implementación de servidor MCP (Protocolo de Contexto de Modelo) que proporciona herramientas de IA para buscar utilizando la API de búsqueda web de YaCy.

Instalación

1. Asegúrate de tener uv instalado:

pip install uv

2. Instala el paquete en modo de desarrollo:

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

O alternativamente:

cd yacy-mcp
uv pip install -e .

Uso

1. Asegúrate de tener un servidor YaCy en ejecución (normalmente en http://localhost:8090)
2. Establece las variables de entorno (opcional):

export YACY_URL=http://localhost:8090

3. Ejecuta el servidor MCP:

python -m yacy_mcp

Configuración

El servidor se puede configurar utilizando variables de entorno:

• YACY_URL: URL de tu instancia de YaCy (predeterminado: http://localhost:8090)

Herramientas Disponibles

• yacy-search: Buscar utilizando el motor de búsqueda web de YaCy
  • Parámetros:
    • query (cadena, obligatorio): Cadena de consulta de búsqueda
    • max_results (entero, opcional): Número máximo de resultados a devolver (predeterminado: 10)
    • resource (cadena, opcional): Recurso de búsqueda (local o global, predeterminado: global)

Configuración de MCP para Aplicaciones de IA

Para utilizar este servidor con aplicaciones de IA que admitan el Protocolo de Contexto de Modelo (MCP), configura tu cliente MCP para conectarse al servidor utilizando transporte stdio.

Ejemplo de configuración para Claude Desktop (settings.json):

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

Para otras aplicaciones compatibles con MCP, utiliza el comando uvx yacy_mcp como ejecutable del servidor. El servidor se obtendrá y ejecutará automáticamente desde PyPI.

Integración con Aplicaciones de IA

Este servidor MCP se puede utilizar con aplicaciones de IA que admitan el Protocolo de Contexto de Modelo para realizar búsquedas web utilizando el motor de búsqueda de YaCy.