Servidor MCP de Kagi

Instrucciones de configuración

Antes de nada, a menos que solo utilices herramientas que no sean de búsqueda, asegúrate de tener acceso a la API de búsqueda. Actualmente se encuentra en fase beta cerrada y disponible bajo petición. Por favor, contacta con support@kagi.com para obtener una invitación.

Instala uv primero.

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Instalación a través de Smithery

Alternativamente, puedes instalar Kagi para Claude Desktop a través de Smithery:

npx -y @smithery/cli install kagimcp --client claude

Configuración con OpenAI

Codex CLI

Para añadir el servidor MCP de Kagi a codex cli, necesitarás usar el siguiente comando:

codex mcp add kagi --env KAGI_API_KEY=<YOUR_API_KEY_HERE> -- uvx kagimcp

Esto escribirá la configuración en ~/.codex/config.toml, así que si necesitas actualizar/rotar tu clave API, actualiza tu clave allí antes de ejecutar codex de nuevo.

Codex CLI viene con su propia búsqueda integrada (mediante el flag --search), pero está desactivada por defecto. Por lo tanto, para evitar conflictos entre la búsqueda y Kagi, simplemente no la habilites.

Configuración con Claude

Claude Desktop

// claude_desktop_config.json
// Can find location through:
// Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
 "mcpServers": {
 "kagi": {
 "command": "uvx",
 "args": ["kagimcp"],
 "env": {
 "KAGI_API_KEY": "YOUR_API_KEY_HERE",
 "KAGI_SUMMARIZER_ENGINE": "YOUR_ENGINE_CHOICE_HERE" // Defaults to "cecil" engine if env var not present
 }
 }
 }
}

Claude Code

Añade el servidor MCP de Kagi con el siguiente comando (configurar el motor de resumen es opcional):

claude mcp add kagi -e KAGI_API_KEY="YOUR_API_KEY_HERE" KAGI_SUMMARIZER_ENGINE="YOUR_ENGINE_CHOICE_HERE" -- uvx kagimcp

Ahora claude code puede usar el servidor MCP de Kagi. Sin embargo, claude code viene con su propia funcionalidad de búsqueda web por defecto, la cual puede entrar en conflicto con Kagi. Puedes desactivar la funcionalidad de búsqueda web de claude con lo siguiente en tu archivo de configuración de claude code (~/.claude/settings.json):

{
 "permissions": {
 "deny": [
 "WebSearch"
 ]
 }
}

Plantear una consulta que requiera el uso de una herramienta

p. ej. "¿Quién fue la persona del año 2024 de la revista Time?" para buscar, o "resume este vídeo: https://www.youtube.com/watch?v=jNQXAC9IVRw" para el resumidor.

Depuración

Ejecuta:

npx @modelcontextprotocol/inspector uvx kagimcp

Related MCP server: Perplexity MCP Server

Instrucciones de configuración local/desarrollo

Clonar el repositorio

git clone https://github.com/kagisearch/kagimcp.git

Instalar dependencias

Instala uv primero.

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Luego instala las dependencias del servidor MCP:

cd kagimcp

# Create virtual environment and activate it
uv venv

source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows

# Install dependencies
uv sync

Configuración con Claude Desktop

Usando el SDK de CLI de MCP

# `pip install mcp[cli]` if you haven't
mcp install /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py -v "KAGI_API_KEY=API_KEY_HERE"

Manualmente

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
 "mcpServers": {
 "kagi": {
 "command": "uv",
 "args": [
 "--directory",
 "/ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp",
 "run",
 "kagimcp"
 ],
 "env": {
 "KAGI_API_KEY": "YOUR_API_KEY_HERE",
 "KAGI_SUMMARIZER_ENGINE": "YOUR_ENGINE_CHOICE_HERE" // Defaults to "cecil" engine if env var not present
 }
 }
 }
}

Plantear una consulta que requiera el uso de una herramienta

p. ej. "¿Quién fue la persona del año 2024 de la revista Time?" para buscar, o "resume este vídeo: https://www.youtube.com/watch?v=jNQXAC9IVRw" para el resumidor.

Depuración

Ejecuta:

# If mcp cli installed (`pip install mcp[cli]`)
mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py

# If not
npx @modelcontextprotocol/inspector \
 uv \
 --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp \
 run \
 kagimcp

Luego accede al Inspector MCP en http://localhost:5173. Es posible que necesites añadir tu clave API de Kagi en las variables de entorno en el inspector bajo KAGI_API_KEY.

Configuración avanzada

• El nivel de registro es ajustable a través de la variable de entorno FASTMCP_LOG_LEVEL (p. ej. FASTMCP_LOG_LEVEL="ERROR")

  • Problema relevante: https://github.com/kagisearch/kagimcp/issues/4

• El motor de resumen se puede personalizar usando la variable de entorno KAGI_SUMMARIZER_ENGINE (p. ej. KAGI_SUMMARIZER_ENGINE="daphne")

  • Aprende sobre los diferentes motores de resumen aquí

• Puede haber formas más seguras de conectarse al MCP. Un usuario escribió algunos detalles aquí

• La opción de CLI --http se puede usar para activar el transporte HTTP transmitible. Se puede usar junto con los argumentos --port y --host.

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers