Kagi MCP Server
OfficialServidor 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 | shWindows:
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 claudeConfiguració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 kagimcpEsto 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 kagimcpAhora 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 kagimcpRelated MCP server: sysauto Ask 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 | shWindows:
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 syncConfiguració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 \
kagimcpLuego 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
--httpse puede usar para activar el transporte HTTP transmitible. Se puede usar junto con los argumentos--porty--host.
Available Tools
2 toolskagi_extractA
Extract the content of a web page as markdown using the Kagi Extract API. Use this to read the full content of a page when needed.
Inputs: url (required). Returns: result
kagi_search_fetchA
Fetch web results for a query using the Kagi Search API. Use for general search and when the user explicitly tells you to 'fetch' results/information. Results are numbered so that a user may refer to a result by a specific number.
Inputs: query (required), after, limit, before, +7 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
Each tool has a clearly distinct purpose: one extracts page content, the other fetches search results. There is no overlap or ambiguity between them.
Both tools follow a consistent 'kagi_' prefix combined with a verb_noun pattern ('extract' and 'search_fetch'), making naming predictable and clear.
With only two tools, the set is minimal but still covers the core search and extract functionalities. However, it feels thin compared to typical MCP servers, which might offer more diverse operations.
The server provides the essential operations for its domain: searching and retrieving content. While additional tools like summarization could be useful, the current set is reasonably complete for basic tasks.
Maintenance
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Web search API and MCP server for developers building AI agents.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server that enables Claude to perform web searches using Perplexity's API with intelligent model selection based on query intent and support for domain and recency filtering.64MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that integrates with Sonar API to provide Claude with real-time web search capabilities for comprehensive research.MIT
- AlicenseDqualityDmaintenanceMCP server that provides Claude AI assistants with the ability to search the web, get news, and perform research using the You.com API.42MIT
- AlicenseCqualityDmaintenanceMCP server integrating the Kagi Search API to perform web searches using the kagi_search tool.1MIT