Kagi Search

Kagi MCP Server

Kagi API tarafından desteklenen bir MCP sunucusu. MCP uyumlu istemcilere arama ve içerik çıkarma araçları sunar.

Araçlar

• kagi_search_fetch - isteğe bağlı sayfa içerikleri, filtreler ve Kagi lensleriyle web, haber, video, podcast ve görsel araması.
• kagi_extract - bir sayfanın tüm içeriğini markdown olarak getirir.

Not: Önceki kagi_fastgpt ve kagi_summarizer araçları kaldırıldı. Her ikisinin de gelecekteki bir sürümde geri dönmesi planlanıyor.

Barındırılan Sunucu

https://mcp.kagi.com/mcp adresinde barındırılan bir MCP sunucusu çalıştırıyoruz — kurulum gerekmez. HTTP destekleyen herhangi bir MCP istemcisini bu sunucuya yönlendirin ve Kagi API anahtarınızla kimlik doğrulaması yapın.

OAuth2 henüz desteklenmiyor (yol haritamızda yer alıyor); şimdilik API anahtarınızı kontrol panelinden alın ve Bearer HTTP kimlik doğrulaması üzerinden iletin.

Claude Code ile örnek:

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

Kendiniz çalıştırmayı mı tercih ediyorsunuz? Yerel uvx kurulumu için İstemci Kurulumu bölümüne, HTTP sunucusunu kendi altyapınızda barındırmak için Kendi Sunucunuzu Barındırma bölümüne bakın.

Gereksinimler

• KAGI_API_KEY içinde bir Kagi API anahtarı.
• Önerilen uvx kurulum yöntemi için uv.

uv yükleyin:

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

Windows:

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

İstemci Kurulumu

Codex CLI

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

Codex, MCP yapılandırmasını ~/.codex/config.toml konumuna yazar.

Claude Desktop

Önce uv'yi yükleyin.

MacOS/Linux:

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

Windows:

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

Ardından Claude Desktop yapılandırma dosyanızda (Settings -> Developer -> Edit Config üzerinden bulunabilir):

{
  "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

Aynı mcpServers JSON'ını kullanarak Kiro MCP yapılandırma dosyanıza (~/.kiro/settings/mcp.json genel kapsamlı, .kiro/settings/mcp.json ise proje kapsamlıdır) ekleyin; Claude Desktop bölümüne bakın. Daha fazla bilgi için Kiro MCP belgelerine bakın.

OpenCode

OpenCode yapılandırma dosyasını ~/.config/opencode/opencode.json konumunda düzenleyin ve aşağıdakini ekleyin:

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

Kullanım Örnekleri

• Arama: Who was Time's 2024 person of the year?
• İçerik çıkarma: extract the full content of https://en.wikipedia.org/wiki/Model_Context_Protocol

Yapılandırma

Ortam değişkeni	Açıklama
KAGI_API_KEY	Gerekli Kagi API anahtarı.
FASTMCP_LOG_LEVEL	Günlük kaydı düzeyi; örneğin ERROR.
KAGI_SEARCH_TIMEOUT	Saniye cinsinden arama zaman aşımı. Varsayılan değer 10.
KAGI_EXTRACT_TIMEOUT	Saniye cinsinden içerik çıkarma zaman aşımı. Varsayılan değer 30.
KAGI_MAX_RETRIES	İlk isteğin ardından yapılacak en fazla yeniden deneme sayısı. Varsayılan değer 2; yeniden denemeleri devre dışı bırakmak için 0 değerini ayarlayın.
KAGI_HIDDEN_PARAMS	LLM'ye sunulan şemadan gizlenecek, virgülle ayrılmış arama parametreleri.
KAGI_SEARCH_FORMAT	Arama sonucu biçimi: json (varsayılan) veya markdown (Search API'nin kendi markdown biçimi, olduğu gibi aktarılır).

Gizlenebilir arama parametreleri:

workflow, extract_count, limit, include_domains, exclude_domains, time_relative, after, before, file_type, lens_id

Örnek:

KAGI_HIDDEN_PARAMS="extract_count,after,before,time_relative,include_domains,exclude_domains"

Yerel Geliştirme

git clone https://github.com/kagisearch/kagimcp.git
cd kagimcp
uv sync

stdio üzerinden yerel olarak çalıştırın:

KAGI_API_KEY=<YOUR_API_KEY_HERE> uv run kagimcp

Akışlı HTTP aktarımıyla çalıştırın:

KAGI_API_KEY=<YOUR_API_KEY_HERE> uv run kagimcp --http --host 0.0.0.0 --port 8000

Kendi Sunucunuzu Barındırma

HTTP modu çok kiracılıdır: her istek, sunucu genelinde bir ortam değişkeni yerine API anahtarını Authorization: Bearer <key> başlığı üzerinden iletir; böylece tek bir örnek birden fazla kullanıcıya hizmet verebilir. Depoda, PyPI'dan sabitlenmiş bir kagimcp yükleyen ve HTTP modunda çalıştıran bir Dockerfile bulunur. Kapsayıcı, $PORT değişkenini dikkate alır; bu sayede bu değişkeni sağlayan tüm platformlarda (Railway, Render, Cloud Run, Fly.io vb.) çalışır.

Yerel olarak derleyip çalıştırın:

docker build -t kagimcp-hosted .
docker run --rm -p 8000:8000 kagimcp-hosted

Hızlı test:

curl -sL http://127.0.0.1:8000/mcp -X POST \
  -H "authorization: Bearer $KAGI_API_KEY" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Üretimdeki sürümü yükseltmek için Dockerfile içindeki sabitlenmiş sürümü düzenleyip yeniden dağıtın.

Hata Ayıklama

Yayımlanmış paketi inceleyin:

npx @modelcontextprotocol/inspector uvx kagimcp

Yerel bir çalışma kopyasını inceleyin:

npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/kagimcp run kagimcp

Denetleyici genellikle http://localhost:5173 adresinde kullanılabilir.

Ön Sürüm Talimatları

Ön sürüm derlemesi kullanıyorsanız aynı kurulum talimatları geçerlidir; ancak uvx kagimcp yerine uvx --prerelease allow --from kagimcp==1.0.0rc2 kagimcp kullanın (1.0.0rc2 yerine yüklemek istediğiniz sürümü yazın).