Kagi MCP server

Инструкции по настройке

Прежде чем начать, если вы не используете только инструменты, не связанные с поиском, убедитесь, что у вас есть доступ к API поиска. В настоящее время он находится в стадии закрытого бета-тестирования и предоставляется по запросу. Пожалуйста, напишите на support@kagi.com, чтобы получить приглашение.

Сначала установите uv.

MacOS/Linux:

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

Windows:

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 kagimcp

Related MCP server: Perplexity MCP Server

Инструкции по локальной настройке/разработке

Клонирование репозитория

git clone https://github.com/kagisearch/kagimcp.git

Установка зависимостей

Сначала установите uv.

MacOS/Linux:

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

Windows:

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.

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers