Kagi

Integración de la API de búsqueda de Kagi

GitHub
45
Prueba este MCPPatrocinado

Documentación

kagi-server MCP Server

smithery badge Servidor MCP para la integración de la API de Kagi

Este es un servidor MCP basado en TypeScript que integra la API de búsqueda de Kagi. Demuestra conceptos centrales de MCP al proporcionar:

  • Herramientas para realizar búsquedas web y otras operaciones usando la API de Kagi (actualmente en beta privada)

Características

Herramientas Implementadas

  • kagi_search - Realizar búsquedas web usando Kagi
    • Toma una cadena de consulta y un límite opcional como parámetros
    • Devuelve resultados de búsqueda de la API de Kagi

Herramientas Planificadas (Aún No Implementadas)

  • kagi_summarize - Generar resúmenes de páginas web o texto
  • kagi_fastgpt - Obtener respuestas rápidas usando FastGPT de Kagi
  • kagi_enrich - Obtener resultados de noticias enriquecidos sobre temas específicos

Desarrollo

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Configuración del Entorno

Crea un archivo .env en el directorio raíz con tu clave de API de Kagi:

KAGI_API_KEY=your_api_key_here

Asegúrate de agregar .env a tu archivo .gitignore para mantener tu clave de API segura.

Instalación

Instalación mediante Smithery

Para instalar Kagi Server para Claude Desktop automáticamente mediante Smithery:

npx @smithery/cli install kagi-server --client claude

Para usar con Claude Desktop, agrega la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kagi-server": {
      "command": "/path/to/kagi-server/build/index.js",
      "env": {
        "KAGI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. Recomendamos usar MCP Inspector, que está disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.

Uso

Una vez que el servidor esté en ejecución y conectado a Claude Desktop, puedes usarlo para realizar búsquedas web. Por ejemplo:

  1. Pregunta a Claude: "¿Puedes buscar información sobre los últimos avances en computación cuántica?"
  2. Claude usará la herramienta kagi_search para obtener resultados de la API de Kagi.
  3. Claude luego resumirá o analizará los resultados de búsqueda para ti.

Nota: Las herramientas planificadas (summarize, fastgpt, enrich) aún no están implementadas y no pueden usarse.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request. Algunas áreas para contribuir incluyen:

  • Implementar las herramientas planificadas (summarize, fastgpt, enrich)
  • Mejorar el manejo de errores y la validación de entrada
  • Mejorar la documentación y los ejemplos de uso

Licencia

Este proyecto está licenciado bajo la Licencia MIT.

Hoja de Ruta

  • Implementar la herramienta kagi_summarize para resumir páginas web y texto
  • Implementar la herramienta kagi_fastgpt para respuestas rápidas
  • Implementar la herramienta kagi_enrich para obtener resultados de noticias enriquecidos
  • Mejorar el manejo de errores y agregar una validación de entrada más robusta
  • Agregar ejemplos de uso y documentación más completos
  • Publicar el paquete en npm para facilitar la instalación y el uso con Claude Desktop y npx