Servidor MCP kagi-server

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 los conceptos básicos de MCP al proporcionar:

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

Características

Herramientas implementadas

• kagi_search - Realiza 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 - Genera resúmenes de páginas web o texto

• kagi_fastgpt : obtenga respuestas rápidas utilizando FastGPT de Kagi

• kagi_enrich - Obtener resultados de noticias enriquecidos sobre temas específicos

Related MCP server: Kagi MCP Server

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Configuración del entorno

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

KAGI_API_KEY=your_api_key_here

Asegúrese de agregar .env a su archivo .gitignore para mantener su clave API segura.

Instalación

Instalación mediante herrería

Para instalar Kagi Server para Claude Desktop automáticamente a través de Smithery :

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

Para utilizar con Claude Desktop, agregue 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 complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

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

Uso

Una vez que el servidor esté en funcionamiento y conectado a Claude Desktop, podrá usarlo para realizar búsquedas web. Por ejemplo:

1. Pregúntale a Claude: "¿Puedes buscar información sobre los últimos avances en computación cuántica?"

2. Claude utilizará la herramienta kagi_search para obtener resultados de la API de Kagi.

3. Luego, Claude resumirá o analizará los resultados de la búsqueda para usted.

Nota: Las herramientas planificadas (resumir, fastgpt, enriquecer) aún no están implementadas y no se pueden utilizar.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Algunas áreas de contribución incluyen:

• Implementar las herramientas planificadas (resumir, fastgpt, enriquecer)

• Mejorar el manejo de errores y la validación de entradas

• 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 el resumen de páginas web y texto

• Implementar la herramienta kagi_fastgpt para obtener 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

• Agregue ejemplos de uso y documentación más completos

• Publique el paquete en npm para facilitar su instalación y uso con Claude Desktop y npx