KK

kagisearch/kagimcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

551 stars 50 forks Качество 86 Тренд 42MIT

Официальный сервер Model Context Protocol (MCP) для Kagi Search и других инструментов.

Обзор

MCP-сервер, поддерживаемый API Kagi. Он предоставляет инструменты поиска и извлечения для совместимых с MCP клиентов. - - веб, новости, видео, подкасты и поиск изображений с опциональными выдержками страниц, фильтрами и линзами Kagi. - - получить полный контент страницы в виде markdown. Предыдущие инструменты kagi_fastgpt и kagi_summarizer были удалены. Планируется вернуть оба в будущем выпуске. Мы запускаем размещённый MCP-сервер — установка не требуется. Направьте на него любого MCP-клиента с поддержкой HTTP и аутентифицируйтесь с помощью вашего ключа Kagi API. OAuth2 пока не поддерживается (он есть в нашей дорожной карте), поэтому пока возьмите свой API-ключ с панели управления и передайте его через аутентификация Bearer HTTP. Предпочитаете запускать его самостоятельно? Смотрите Client Setup для локальной установки uvx или Self-Hosting для размещения HTTP-сервера на вашей собственной инфраструктуре. - Ключ Kagi API в KAGI_API_KEY. - UV для рекомендуемого пути установки UVX. Codex записывает конфигурацию MCP в ~/.codex/config.toml.

Обзор (машинный перевод)

MCP-сервер, поддерживаемый API Kagi. Он предоставляет инструменты поиска и извлечения для совместимых с MCP клиентов.

Инструменты

  • kagi_search_fetch — веб, новости, видео, подкасты и поиск изображений с опциональными выдержками из страниц, фильтрами и линзами Kagi.
  • kagi_extract — получить полный контент страницы в виде разметки.

Примечание: Предыдущие kagi_fastgpt и kagi_summarizer инструменты были удалены. Планируется возвращение в будущем выпуске.

Хостинг сервера

Мы запускаем размещённый MCP-сервер по адресу https://mcp.kagi.com/mcp — установка не требуется. Направьте на него любого MCP-клиента с поддержкой HTTP и аутентифицируйте с помощью вашего ключа Kagi API.

OAuth2 пока не поддерживается (он есть в нашей дорожной карте), поэтому пока возьмите свой API-ключ с панели управления и передайте его через Bearer HTTP-аутентификацию.

Пример с кодом Клода:

Предпочитаете запускать его самостоятельно? Смотрите Client Setup для локальной установки uvx или Self-Hosting для размещения HTTP-сервера на вашей собственной инфраструктуре.

Требования

  • Ключ Kagi API в KAGI_API_KEY.
  • uv для рекомендуемого пути установки uvx.

Установите uv:

Окна:

Настройка клиента

Кодекс CLI

Codex записывает конфигурацию MCP в ~/.codex/config.toml.

Клод Десктоп

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

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Kagi MCP Server

An MCP server backed by the Kagi API. It exposes search and extraction tools to MCP-compatible clients.

Tools

  • kagi_search_fetch - web, news, videos, podcasts, and image search with optional page extracts, filters, and Kagi lenses.
  • kagi_extract - fetch a page’s full content as markdown.

Note: The previous kagi_fastgpt and kagi_summarizer tools have been removed. Both are planned to return in a future release.

Hosted Server

We run a hosted MCP server at https://mcp.kagi.com/mcp — no install required. Point any HTTP-capable MCP client at it and authenticate with your Kagi API key.

OAuth2 isn’t supported yet (it’s on our roadmap), so for now grab your API key from the dashboard and pass it via Bearer HTTP authentication.

Example with Claude Code:

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

Prefer to run it yourself? See Client Setup for the local uvx install, or Self-Hosting to host the HTTP server on your own infrastructure.

Requirements

  • A Kagi API key in KAGI_API_KEY.
  • uv for the recommended uvx install path.

Install uv:

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

Windows:

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

Client Setup

Codex CLI

codex mcp add kagi --env KAGI_API_KEY= -- uvx kagimcp

Codex writes MCP configuration to ~/.codex/config.toml.

Claude Desktop

Install uv first.

MacOS/Linux:

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

Windows:

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

Then in your Claude Desktop config (found through Settings -> Developer -> Edit Config):

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

Claude Code

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

Smithery

npx -y @smithery/cli install kagimcp --client claude

Kiro

Add to your Kiro MCP config file (~/.kiro/settings/mcp.json for global, or .kiro/settings/mcp.json for project-scoped) using the same mcpServers JSON as Claude Desktop. See the Kiro MCP documentation for more details.

OpenCode

Edit the OpenCode configuration file in ~/.config/opencode/opencode.json and add the following:

{
  "mcp": {
    "kagi": {
      "type": "local",
      "command": ["uvx", "kagimcp"],
      "enabled": true,
      "environment": {
        "KAGI_API_KEY": ""
      }
    }
  }
}
Открыть полный README на GitHub

Установка

uvx kagimcp
Новичок в MCP? Начните с руководства на mcpskill.org →

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

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