kindly-web-search-mcp-server MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

web_search devuelve page_content en Markdown, no solo título/fragmento
get_content realiza descargas completas conscientes de la plataforma (hilos de SO, Issues de GitHub, arXiv)
Soporta Serper (principal), Tavily (alternativa) o SearXNG autohospedado
GITHUB_TOKEN opcional habilita la extracción estructurada de Issues de GitHub
Funciona desde Claude Code, Codex, Cursor, Copilot, Gemini, Antigravity

Demo en vivo

Cómo se ve en la práctica

kindly-web-search.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kindly-web-search": {
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "kindly-web-search",
      "command": "uvx",
      "args": [
        "kindly-web-search-mcp-server"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "kindly-web-search": {
      "command": {
        "path": "uvx",
        "args": [
          "kindly-web-search-mcp-server"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add kindly-web-search -- uvx kindly-web-search-mcp-server

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: kindly-web-search-mcp-server

Depurar un error de biblioteca leyendo el hilo completo de StackOverflow

👤 Desarrolladores que se encuentran con un error críptico ⏱ ~10 min beginner

Cuándo usarlo: La respuesta principal de SO a menudo no es correcta; la conversación debajo tiene la solución real.

Requisitos previos

SERPER_API_KEY — serper.dev — 2500 consultas gratuitas/mes

Flujo

Buscar el error exacto

Busca: 'fatal error: 'openssl/opensslv.h' file not found' arm64 mac — devuelve las 3 URLs principales de SO.✓ Copiado

→ URLs de SO con fragmentos
Descargar el hilo completo del más relevante

get_content en la URL principal de SO — dame el hilo completo incluyendo cada comentario.✓ Copiado

→ Preguntas+Respuestas+comentarios completos en Markdown
Elige la solución que el consenso del hilo respalda

¿Qué respuesta (incluyendo las que están debajo de la aceptada) validan realmente los comentarios del hilo? Muéstrame los comandos exactos.✓ Copiado

→ Secuencia de comandos específica

Resultado: La solución real, no solo la respuesta aceptada — con evidencia de los comentarios.

Errores comunes

Las páginas de SO pueden ser enormes; el contenido completo puede ser 10k+ tokens — Pide primero un resumen ejecutivo, luego profundiza

Combinar con: filesystem

Leer una GitHub Issue larga con contexto completo

👤 Ingenieros evaluando si actualizar una dependencia ⏱ ~10 min beginner

Cuándo usarlo: La issue tiene 80 comentarios y necesitas la señal en el ruido.

Requisitos previos

GITHUB_TOKEN (opcional pero recomendado) — Un token clásico o granular; conjunto de permisos vacío está bien para repos públicos

Flujo

Extraer datos estructurados de la issue

get_content en https://github.com/vercel/next.js/issues/12345 — devuelve metadatos estructurados más cuerpo y todos los comentarios.✓ Copiado

→ Extracción estructurada, no HTML sin procesar
Destila la señal

Resumen: ¿está corregido, abierto, solo solución alternativa? ¿Quién del equipo de mantenimiento ha comentado y cuál fue su última posición?✓ Copiado

→ Estado + posición del mantenedor

Resultado: Una decisión fundamentada de hacer/no hacer en una actualización de biblioteca.

Combinar con: github

Resumir un artículo de arXiv con acceso al texto completo

👤 Investigadores, desarrolladores curiosos ⏱ ~10 min beginner

Cuándo usarlo: No quieres un fragmento; quieres citar la sección 3.2.

Flujo

Descargar el artículo

get_content https://arxiv.org/abs/2410.XXXXX — texto completo.✓ Copiado

→ Markdown del artículo
Resumen dirigido

Resume la metodología (sección 3) en 5 puntos y cita la afirmación clave de la tabla de resultados.✓ Copiado

→ Resumen con cita textual

Resultado: Comprensión del artículo sin salir del chat.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

kindly-web-search + github

Kindly lee la discusión de la issue; github MCP crea una issue de seguimiento en tu repo

Lee la discusión en open-upstream/project#432 vía kindly, luego abre una issue de seguimiento en el repo de nuestro equipo resumiéndola.✓ Copiado

kindly-web-search + filesystem

Guarda respuestas investigadas como notas Markdown

Investiga 'best practices for Postgres connection pooling with pgbouncer', guarda el hilo completo de SO + dos enlaces de documentos bajo ./notes/pgbouncer.md.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
web_search	query: str, num_results?: int (default 3)	Cualquier búsqueda web que de todos modos hubieras seguido con una descarga	1 llamada del proveedor de búsqueda + N descargas
get_content	url: str	Profundizar en una URL específica	1 descarga (más operaciones del proveedor para análisis de plataforma)

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Serper: 2500/mes gratuito. Tavily: 1000/mes gratuito. SearXNG autohospedado: ilimitado.
Tokens por llamada: web_search con contenido completo: 2-6k por llamada. get_content: 1-10k dependiendo de la página.
Monetario: Gratuito con niveles gratuitos del proveedor; autohospeda SearXNG para costo cero
Consejo: Para investigación iterativa, reduce num_results a 2 — kindly devuelve contenido completo por resultado, así que 3 puede ser caro.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Variables de entorno: SERPER_API_KEY o TAVILY_API_KEY o SEARXNG_BASE_URL

Salida de datos: Consultas al proveedor de búsqueda elegido + descargas a URLs de resultados

No conceder nunca: Token de GitHub con escritura en repo — public-read es suficiente para extracción de contenido

El contenido devuelto incluye lo que sirve la página activa — verifica antes de confiar en decisiones críticas de seguridad.
Requiere un navegador Chromium en el host para renderizado de contenido completo.

Resolución de problemas

Errores comunes y soluciones

Ningún proveedor configurado

Establece al menos uno de SERPER_API_KEY, TAVILY_API_KEY o SEARXNG_BASE_URL.

Verificar: env | grep -E 'SERPER|TAVILY|SEARXNG'

Chromium no encontrado

Instala Chrome, Edge, Brave o chromium. Establece PUPPETEER_EXECUTABLE_PATH si la detección automática falla.

Verificar: which google-chrome || which chromium

Error de versión de Python

Requiere Python 3.13+. Actualiza vía pyenv o uv.

Verificar: python3 --version

Alternativas

kindly-web-search-mcp-server vs otros

Alternativa	Cuándo usarla	Contrapartida
omnisearch	Quieres muchos proveedores incluyendo búsqueda de IA en un MCP	Menos consciente de plataforma; fragmentos primero
brave-search	Solo quieres búsqueda, no recuperaci��n de contenido completo	Solo fragmentos
fetch MCP	No necesitas búsqueda, solo descarga de URL	Sin búsqueda

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills