Kagi MCP Server
OfficialKagi MCP server
Инструкции по настройке
Прежде чем начать, если вы не используете только инструменты, не связанные с поиском, убедитесь, что у вас есть доступ к API поиска. В настоящее время он находится в стадии закрытого бета-тестирования и предоставляется по запросу. Пожалуйста, напишите на support@kagi.com, чтобы получить приглашение.
Сначала установите uv.
MacOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Установка через Smithery
Альтернативно, вы можете установить Kagi для Claude Desktop через Smithery:
npx -y @smithery/cli install kagimcp --client claudeНастройка с OpenAI
Codex CLI
Чтобы добавить MCP-сервер Kagi в codex cli, вам нужно использовать следующую команду:
codex mcp add kagi --env KAGI_API_KEY=<YOUR_API_KEY_HERE> -- uvx kagimcpЭто запишет конфигурацию в ~/.codex/config.toml, поэтому, если вам нужно обновить/сменить API-ключ, обновите его там перед повторным запуском codex.
Codex CLI поставляется со своим встроенным поиском (через флаг --search), но по умолчанию он отключен. Поэтому, чтобы избежать конфликтов между поиском и Kagi, просто не включайте его.
Настройка с 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
Добавьте MCP-сервер Kagi с помощью следующей команды (установка движка суммаризации опциональна):
claude mcp add kagi -e KAGI_API_KEY="YOUR_API_KEY_HERE" KAGI_SUMMARIZER_ENGINE="YOUR_ENGINE_CHOICE_HERE" -- uvx kagimcpТеперь claude code может использовать MCP-сервер Kagi. Однако claude code по умолчанию имеет собственную функцию веб-поиска, которая может конфликтовать с Kagi. Вы можете отключить функцию веб-поиска Claude, добавив следующее в файл настроек claude code (~/.claude/settings.json):
{
"permissions": {
"deny": [
"WebSearch"
]
}
}Задайте запрос, требующий использования инструмента
например, "Who was time's 2024 person of the year?" для поиска или "summarize this video: https://www.youtube.com/watch?v=jNQXAC9IVRw" для суммаризатора.
Отладка
Запустите:
npx @modelcontextprotocol/inspector uvx kagimcpRelated MCP server: sysauto Ask MCP Server
Инструкции по локальной настройке/разработке
Клонирование репозитория
git clone https://github.com/kagisearch/kagimcp.git
Установка зависимостей
Сначала установите uv.
MacOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shWindows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Затем установите зависимости 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Настройка с Claude Desktop
Использование 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"Вручную
# 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
}
}
}
}Задайте запрос, требующий использования инструмента
например, "Who was time's 2024 person of the year?" для поиска или "summarize this video: https://www.youtube.com/watch?v=jNQXAC9IVRw" для суммаризатора.
Отладка
Запустите:
# 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Затем откройте MCP Inspector по адресу http://localhost:5173. Возможно, вам потребуется добавить ваш API-ключ Kagi в переменные окружения в инспекторе в разделе KAGI_API_KEY.
Расширенная конфигурация
Уровень логирования можно настроить с помощью переменной окружения
FASTMCP_LOG_LEVEL(например,FASTMCP_LOG_LEVEL="ERROR")Соответствующий тикет: https://github.com/kagisearch/kagimcp/issues/4
Движок суммаризации можно настроить с помощью переменной окружения
KAGI_SUMMARIZER_ENGINE(например,KAGI_SUMMARIZER_ENGINE="daphne")Узнайте о различных движках суммаризации здесь
Существуют более безопасные способы подключения к MCP. Пользователь описал некоторые детали здесь
Опцию CLI
--httpможно использовать для включения потокового транспорта HTTP. Можно использовать вместе с аргументами--portи--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