Kagi MCP Server
OfficialKagi MCP-Server
Einrichtungsanweisungen
Stellen Sie vorab sicher, dass Sie Zugriff auf die Such-API haben, es sei denn, Sie verwenden nur Nicht-Such-Tools. Sie befindet sich derzeit in der geschlossenen Beta-Phase und ist auf Anfrage erhältlich. Bitte wenden Sie sich für eine Einladung an support@kagi.com.
Installieren Sie zuerst uv.
MacOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Installation über Smithery
Alternativ können Sie Kagi für Claude Desktop über Smithery installieren:
npx -y @smithery/cli install kagimcp --client claudeEinrichtung mit OpenAI
Codex CLI
Um den Kagi MCP-Server zur codex cli hinzuzufügen, müssen Sie den folgenden Befehl verwenden:
codex mcp add kagi --env KAGI_API_KEY=<YOUR_API_KEY_HERE> -- uvx kagimcpDies schreibt die Konfiguration in ~/.codex/config.toml. Wenn Sie also Ihren API-Schlüssel aktualisieren/rotieren müssen, aktualisieren Sie ihn dort, bevor Sie codex erneut ausführen.
Die Codex CLI verfügt über eine eigene integrierte Suche (über das Flag --search), die jedoch standardmäßig deaktiviert ist. Um Konflikte zwischen der Suche und Kagi zu vermeiden, aktivieren Sie sie einfach nicht.
Einrichtung mit 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
Fügen Sie den Kagi MCP-Server mit dem folgenden Befehl hinzu (die Einstellung der Summarizer-Engine ist optional):
claude mcp add kagi -e KAGI_API_KEY="YOUR_API_KEY_HERE" KAGI_SUMMARIZER_ENGINE="YOUR_ENGINE_CHOICE_HERE" -- uvx kagimcpJetzt kann Claude Code den Kagi MCP-Server verwenden. Claude Code verfügt jedoch standardmäßig über eine eigene Websuchfunktion, die mit Kagi in Konflikt stehen könnte. Sie können die Websuchfunktion von Claude in Ihrer Claude Code-Einstellungsdatei (~/.claude/settings.json) deaktivieren:
{
"permissions": {
"deny": [
"WebSearch"
]
}
}Stellen Sie eine Anfrage, die die Verwendung eines Tools erfordert
z. B. "Wer war die Person des Jahres 2024 laut Time?" für die Suche oder "Fasse dieses Video zusammen: https://www.youtube.com/watch?v=jNQXAC9IVRw" für den Summarizer.
Fehlerbehebung
Führen Sie aus:
npx @modelcontextprotocol/inspector uvx kagimcpRelated MCP server: sysauto Ask MCP Server
Anweisungen für die lokale/Entwicklungs-Einrichtung
Repository klonen
git clone https://github.com/kagisearch/kagimcp.git
Abhängigkeiten installieren
Installieren Sie zuerst uv.
MacOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Installieren Sie dann die MCP-Server-Abhängigkeiten:
cd kagimcp
# Create virtual environment and activate it
uv venv
source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows
# Install dependencies
uv syncEinrichtung mit Claude Desktop
Verwendung des MCP CLI SDK
# `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"Manuell
# 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
}
}
}
}Stellen Sie eine Anfrage, die die Verwendung eines Tools erfordert
z. B. "Wer war die Person des Jahres 2024 laut Time?" für die Suche oder "Fasse dieses Video zusammen: https://www.youtube.com/watch?v=jNQXAC9IVRw" für den Summarizer.
Fehlerbehebung
Führen Sie aus:
# 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 \
kagimcpGreifen Sie dann auf den MCP Inspector unter http://localhost:5173 zu. Möglicherweise müssen Sie Ihren Kagi-API-Schlüssel in den Umgebungsvariablen im Inspector unter KAGI_API_KEY hinzufügen.
Erweiterte Konfiguration
Die Protokollierungsebene kann über die Umgebungsvariable
FASTMCP_LOG_LEVELangepasst werden (z. B.FASTMCP_LOG_LEVEL="ERROR")Relevantes Issue: https://github.com/kagisearch/kagimcp/issues/4
Die Summarizer-Engine kann über die Umgebungsvariable
KAGI_SUMMARIZER_ENGINEangepasst werden (z. B.KAGI_SUMMARIZER_ENGINE="daphne")Erfahren Sie hier mehr über die verschiedenen Summarization-Engines
Es gibt möglicherweise sicherere Wege, sich mit dem MCP zu verbinden. Ein Benutzer hat einige Details hier aufgeschrieben
Die CLI-Option
--httpkann verwendet werden, um den streamfähigen HTTP-Transport zu aktivieren. Kann zusammen mit den Argumenten--portund--hostverwendet werden.
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