MCP-сервер Kagi Session2API

Бесплатный MCP-сервер (Model Context Protocol) для Kagi — доступ к поиску и суммаризатору Kagi через токены сессии, API-ключ не требуется. Работает с Claude Desktop, Cursor, Windsurf, Cline, Hermes и любым ИИ-ассистентом или агентом для программирования, поддерживающим MCP.

English | 中文文档

⚠️ Предупреждение для конечного пользователя: Этот проект использует токены сессии Kagi для доступа к функциям поиска и суммаризации без официального платного API. Это может нарушать Условия использования Kagi. Возможные последствия включают приостановку или пожизненную блокировку аккаунта. Используйте на свой страх и риск. Авторы не несут ответственности за любые действия, предпринятые Kagi в отношении вашего аккаунта.

⚠️ Предупреждение о безопасности: Ваш токен сессии Kagi предоставляет полный доступ к аккаунту. Относитесь к нему как к паролю. Никогда не передавайте его и не добавляйте в системы контроля версий.

Возможности

• Доступ на основе сессии: Использует токены сессии Kagi вместо официального API ($25/1000 запросов) — полностью бесплатно

• Пул из нескольких токенов: Настройка нескольких токенов для повышения пропускной способности с использованием алгоритма циклического перебора (round-robin)

• Ограничение частоты запросов (rate limiting) для каждого токена: 5 запросов в секунду на токен с использованием алгоритма «маркерной корзины» (token bucket)

• API-совместимый вывод: Возвращает результаты в том же формате, что и официальный kagimcp

• Два инструмента: kagi_search_fetch (веб-поиск) и kagi_summarizer (суммаризация URL)

• Подмена UA Firefox: Имитирует реальный браузер Firefox для доступа на основе сессии

• Автоматическое отключение просроченных токенов: Просроченные токены автоматически обнаруживаются и пропускаются

• Операторы поиска: Поддерживает операторы Kagi (site:, lang:, filetype: и т. д.)

Совместимые платформы

Работает с любым MCP-совместимым клиентом:

• Claude Desktop

• Cursor

• Windsurf

• Cline

• Hermes Agent

• Любой MCP-клиент, поддерживающий транспорт stdio или HTTP

Быстрая установка (для ИИ-агентов)

Просто вставьте этот промпт своему ИИ-агенту:

Install the Kagi Session2API MCP server from https://pypi.org/project/kagi-session2api-mcp/.
Then add it to my MCP:
`uvx kagi-session2api-mcp`
set env KAGI_SESSION_TOKEN to my token (ask me if you don't have it).
If I have multiple tokens, use KAGI_SESSION_TOKENS (comma-separated) instead,
or create a config file at ~/.config/kagi-session2api-mcp/config.toml with:
[kagi]
session_tokens = ["TOKEN_1", "TOKEN_2"]
summarizer_engine = "cecil"
[client]
timeout = 30
max_retries = 2
and set env KAGI_SESSION_CONFIG to that path.

Установка вручную

pip install kagi-session2api-mcp

Или с помощью uvx:

uvx kagi-session2api-mcp

Конфигурация

Вариант 1: Переменная окружения (один токен)

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_TOKEN": "YOUR_SESSION_TOKEN_HERE"
      }
    }
  }
}

Вариант 2: Переменная окружения (несколько токенов)

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_TOKENS": "TOKEN_1,TOKEN_2,TOKEN_3"
      }
    }
  }
}

Вариант 3: Файл конфигурации (рекомендуется для нескольких токенов)

Создайте ~/.config/kagi-session2api-mcp/config.toml:

[kagi]
session_tokens = [
    "YOUR_TOKEN_1_HERE",
    "YOUR_TOKEN_2_HERE",
]

summarizer_engine = "cecil"

[client]
timeout = 30
max_retries = 2

Затем настройте:

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_CONFIG": "/path/to/config.toml"
      }
    }
  }
}

Получение токена сессии

1. Войдите на kagi.com

2. Перейдите в Settings → Account → Session Link

3. Скопируйте токен из URL сессии: https://kagi.com/search?token={ЭТА_ЧАСТЬ}&q=test

4. Используйте этот токен в своей конфигурации

Использование

Инструменты MCP

kagi_search_fetch

Поиск в интернете с помощью Kagi:

Search for "Python async tutorial"

Поддерживает операторы поиска Kagi:

• site:github.com — ограничение по домену

• -site:reddit.com — исключение домена

• filetype:pdf — фильтр по типу файла

• intitle:python — фильтр по заголовку

• lang:zh — фильтр по языку

• before:2024-01-01 / after:2024-01-01 — фильтры по дате

• "exact phrase" — точное совпадение

kagi_summarizer

Суммаризация любого URL:

Summarize https://example.com/article

Опции:

• summary_type: "summary" (текст) или "takeaway" (маркированный список)

• engine: "cecil" (по умолчанию), "agnes", "daphne", "muriel"

• target_language: Код языка (например, "EN")

⚠️ Суммаризатор является экспериментальным — он использует внутреннюю конечную точку Kagi, которая может измениться.

Режимы транспорта

Stdio (по умолчанию, для Claude Desktop):

kagi-session2api-mcp

HTTP (для удаленного доступа):

kagi-session2api-mcp --http --host 0.0.0.0 --port 8000

Архитектура

MCP Client → FastMCP Server → TokenPool (round-robin) → httpx.AsyncClient → kagi.com
                                ↓
                          TokenBucket (5 req/s per token)
                                ↓
                          Auto-disable expired tokens

Работа пула токенов

Когда токен истекает (обнаруживается через 401/403 или перенаправление на страницу входа), он автоматически отключается. Оставшиеся токены продолжают обрабатывать запросы.

Отличия от официального kagimcp

Риски

• Kagi может изменить структуру HTML, что приведет к поломке парсера

• Доступ на основе сессии может нарушать Условия использования Kagi

• Возможна приостановка или пожизненная блокировка аккаунта

• Конечная точка суммаризатора является внутренней и может измениться без предупреждения

• Используйте на свой страх и риск. Авторы не несут ответственности за любые последствия, включая, помимо прочего, действия, предпринятые Kagi в отношении вашего аккаунта.

Лицензия

MIT