Kagi MCP Server

Что умеет сервер

Сервер построен на API Kagi и даёт два инструмента. kagi_search_fetch ищет по вебу, новостям, видео, подкастам и картинкам, умеет добавлять к результатам выдержки со страниц, применять фильтры и поисковые линзы Kagi. kagi_extract получает полное содержимое страницы в виде Markdown. Такой набор закрывает типичную цепочку: найти источники и прочитать нужные.

Разработчики сняли прежние инструменты kagi_fastgpt и kagi_summarizer и сообщают, что планируют вернуть их в следующих выпусках, так что опираться на них пока нельзя. Перечень параметров поиска, которые модель видит в схеме, можно сократить переменной KAGI_HIDDEN_PARAMS: например, спрятать after, before, include_domains и exclude_domains, чтобы экономить контекст.

Когда использовать

Сервер подойдёт тем, у кого уже есть доступ к API Kagi и кто хочет, чтобы агент искал через эту систему: для справок, подготовки обзоров и поиска свежих публикаций. Для запросов вроде «кто стал человеком года по версии Time» агенту хватает одного вызова поиска, а для чтения конкретной статьи, например страницы энциклопедии, служит kagi_extract.

Если ключа Kagi нет, возьмите другой поисковый сервер из каталога.

Ограничения и безопасность

Нужен ключ Kagi API в переменной KAGI_API_KEY. Размещённый сервер Kagi пока не поддерживает OAuth2 (в README это записано как планы), поэтому ключ передают заголовком Authorization: Bearer, а ключ берут в кабинете Kagi. В примере для Claude Code ключ вводится скрыто, чтобы он не остался в истории команд оболочки. Для локального запуска рекомендуется менеджер пакетов uv, команда запуска uvx kagimcp.

Таймауты поиска и извлечения по умолчанию равны 10 и 30 секундам (KAGI_SEARCH_TIMEOUT, KAGI_EXTRACT_TIMEOUT), число повторов задаёт KAGI_MAX_RETRIES. При самостоятельном размещении HTTP-режим многопользовательский: каждый запрос приносит свой ключ в заголовке, поэтому закрывайте такой экземпляр от посторонних. Запросы уходят в Kagi, конфиденциальное в них не включайте.

Размещённый сервер, Claude Code

Сервер Kagi работает по адресу https://mcp.kagi.com/mcp, ставить ничего не нужно. Ключ API из кабинета Kagi вводится скрыто при выполнении команды:

claude mcp add kagi https://mcp.kagi.com/mcp --transport http --header "Authorization: Bearer $(read -sp 'API key: ' k; echo $k)" --scope user

Локально, Claude Code

Нужен uv. Установка:

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

В Windows:

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

Добавление сервера:

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

Claude Desktop

В конфигурации Claude Desktop (Settings -> Developer -> Edit Config):

{
  "mcpServers": {
    "kagi": {
      "command": "uvx",
      "args": ["kagimcp"],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Codex CLI

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

Codex записывает настройки в ~/.codex/config.toml.

OpenCode

Файл ~/.config/opencode/opencode.json:

{
  "mcp": {
    "kagi": {
      "type": "local",
      "command": ["uvx", "kagimcp"],
      "enabled": true,
      "environment": {
        "KAGI_API_KEY": "<YOUR_API_KEY_HERE>"
      }
    }
  }
}

Для Kiro используйте тот же блок mcpServers, что и для Claude Desktop, в файле ~/.kiro/settings/mcp.json или .kiro/settings/mcp.json.