MCP de Herramientas Web

Servidor MCP que expone SearXNG, Firecrawl y Camofox como herramientas para agentes/LLMs.

Requisitos

• Python 3.10+
• Instancias accesibles de SearXNG, Firecrawl y/o Camofox

Instalación

pip install -r requirements.txt

Configuración por entorno

Variable	Por defecto	Obligatoria
SEARXNG_URL	http://10.0.1.8:8888	No
FIRECRAWL_URL	http://10.0.1.8:3002	No
FIRECRAWL_API_KEY	—	Sí (para Firecrawl)
CAMOFOX_URL	http://10.0.1.8:9377	No
CAMOFOX_API_KEY	—	No (según config de tu instancia)
OCR_SERVER_URL	http://10.0.1.10:8000	No

Ejemplo:

export SEARXNG_URL=http://10.0.1.8:8888
export FIRECRAWL_URL=http://10.0.1.8:3002
export FIRECRAWL_API_KEY=fc-tu-api-key
export CAMOFOX_URL=http://10.0.1.8:9377
export CAMOFOX_API_KEY=cf-tu-api-key
export OCR_SERVER_URL=http://10.0.1.10:8000

Ejecución

Stdio (para Claude Desktop, Cursor, etc.)

python server.py

El servidor usa stdio por defecto. Para streamable HTTP:

python server.py --transport streamable-http --port 8000

Agrega esto a claude_desktop_config.json:

{
  "mcpServers": {
    "herramientas-web": {
      "command": "python",
      "args": ["/ruta/completa/a/server.py"],
      "env": {
        "SEARXNG_URL": "http://10.0.1.8:8888",
        "FIRECRAWL_URL": "http://10.0.1.8:3002",
        "FIRECRAWL_API_KEY": "fc-tu-api-key",
        "CAMOFOX_URL": "http://10.0.1.8:9377"
      }
    }
  }
}

Herramientas disponibles

SearXNG (metabuscador)

Herramienta	Descripción
searxng_buscar	Busca con soporte de categorías, paginación, idioma y filtro temporal

Firecrawl (scraping/extracción)

Herramienta	Descripción
firecrawl_obtener	Scrapea una URL (markdown, html, text, screenshot)
firecrawl_buscar	Busca en la web y devuelve resultados con contenido
firecrawl_mapa	Descubre todas las URLs de un sitio
firecrawl_rastrear	Rastrea un sitio completo
firecrawl_extraer	Extrae datos estructurados de URLs

Camofox (navegador anti-detección)

Herramienta	Descripción
camofox_navegar	Navega a una URL y devuelve el contenido accesible
camofox_obtener_instantanea	Obtiene snapshot de accesibilidad de la página actual
camofox_hacer_click	Hace clic en un elemento de la página
camofox_escribir	Escribe texto en un campo
camofox_capturar_pantalla	Toma captura de pantalla (base64)
camofox_transcribir_youtube	Obtiene transcripción de un video de YouTube
camofox_buscar	Busca usando macros (google, youtube, amazon, reddit, etc.)

OCR (iOS Vision Framework)

Herramienta	Descripción
ocr_imagen_url	Reconoce texto en una imagen desde una URL pública
ocr_imagen_base64	Reconoce texto en una imagen codificada en base64
ocr_documento_url	Reconoce texto con detección de párrafos desde una URL (iOS 26+)
ocr_documento_base64	Reconoce texto con detección de párrafos desde base64 (iOS 26+)