Kagi Session2API MCP-Server

Ein kostenloser Kagi Search MCP-Server (Model Context Protocol) – greifen Sie über Sitzungs-Tokens auf die Kagi-Suche und den Zusammenfassungsdienst zu, ohne dass ein API-Schlüssel erforderlich ist. Funktioniert mit Claude Desktop, Cursor, Windsurf, Cline, Hermes und jedem MCP-kompatiblen KI-Coding-Assistenten/Agenten.

Englisch | Chinesische Dokumentation

⚠️ Warnung für Endbenutzer: Dieses Projekt verwendet Kagi-Sitzungs-Tokens, um auf Such- und Zusammenfassungsfunktionen ohne die offizielle kostenpflichtige API zuzugreifen. Dies kann gegen die Nutzungsbedingungen von Kagi verstoßen. Mögliche Konsequenzen sind die Sperrung des Kontos oder ein dauerhafter Ausschluss. Die Nutzung erfolgt auf eigenes Risiko. Die Autoren übernehmen keine Haftung für Maßnahmen, die Kagi gegen Konten ergreift.

⚠️ Sicherheitshinweis: Ihr Kagi-Sitzungs-Token bietet vollen Zugriff auf Ihr Konto. Behandeln Sie es wie ein Passwort. Geben Sie es niemals weiter und speichern Sie es nicht in der Versionsverwaltung.

Funktionen

• Sitzungsbasierter Zugriff: Verwendet Kagi-Sitzungs-Tokens anstelle der offiziellen API ($25/1000 Abfragen) – komplett kostenlos

• Multi-Token-Pool: Konfigurieren Sie mehrere Tokens für einen höheren Durchsatz mit Round-Robin-Rotation

• Ratenbegrenzung pro Token: 5 Anfragen/Sekunde pro Token mit Token-Bucket-Algorithmus

• API-kompatible Ausgabe: Gibt Ergebnisse im gleichen Format wie das offizielle kagimcp zurück

• Zwei Tools: kagi_search_fetch (Websuche) und kagi_summarizer (URL-Zusammenfassung)

• Firefox UA-Spoofing: Ahmt einen echten Firefox-Browser für den sitzungsbasierten Zugriff nach

• Automatische Deaktivierung abgelaufener Tokens: Abgelaufene Tokens werden automatisch erkannt und übersprungen

• Suchoperatoren: Unterstützt Kagi-Operatoren (site:, lang:, filetype: usw.)

Kompatible Plattformen

Funktioniert mit jedem MCP-kompatiblen Client:

• Claude Desktop

• Cursor

• Windsurf

• Cline

• Hermes Agent

• Jeder MCP-Client, der stdio oder HTTP-Transport unterstützt

Schnellinstallation (für KI-Agenten)

Fügen Sie einfach diesen Prompt in Ihren KI-Agenten ein:

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.

Manuelle Installation

pip install kagi-session2api-mcp

Oder mit uvx:

uvx kagi-session2api-mcp

Konfiguration

Option 1: Umgebungsvariable (Einzelnes Token)

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

Option 2: Umgebungsvariable (Mehrere Tokens)

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

Option 3: Konfigurationsdatei (Empfohlen für mehrere Tokens)

Erstellen Sie ~/.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

Konfigurieren Sie dann:

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

Abrufen Ihres Sitzungs-Tokens

1. Melden Sie sich bei kagi.com an

2. Gehen Sie zu Einstellungen → Konto → Sitzungs-Link

3. Kopieren Sie das Token aus der Sitzungs-URL: https://kagi.com/search?token={DIESER_TEIL}&q=test

4. Verwenden Sie dieses Token in Ihrer Konfiguration

Verwendung

MCP-Tools

kagi_search_fetch

Durchsuchen Sie das Web mit Kagi:

Search for "Python async tutorial"

Unterstützt Kagi-Suchoperatoren:

• site:github.com - Auf Domain beschränken

• -site:reddit.com - Domain ausschließen

• filetype:pdf - Dateityp-Filter

• intitle:python - Titel-Filter

• lang:zh - Sprachfilter

• before:2024-01-01 / after:2024-01-01 - Datumsfilter

• "exakte phrase" - Exakte Übereinstimmung

kagi_summarizer

Fassen Sie eine beliebige URL zusammen:

Summarize https://example.com/article

Optionen:

• summary_type: "summary" (Fließtext) oder "takeaway" (Stichpunkte)

• engine: "cecil" (Standard), "agnes", "daphne", "muriel"

• target_language: Sprachcode (z. B. "DE")

⚠️ Der Zusammenfassungsdienst ist experimentell – er verwendet Kagis internen Endpunkt, der sich ändern kann.

Transportmodi

Stdio (Standard, für Claude Desktop):

kagi-session2api-mcp

HTTP (für Fernzugriff):

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

Architektur

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

Verhalten des Token-Pools

Wenn ein Token abläuft (erkannt durch 401/403 oder Weiterleitung zum Login), wird es automatisch deaktiviert. Verbleibende Tokens bedienen weiterhin Anfragen.

Unterschiede zum offiziellen kagimcp

Risiken

• Kagi könnte die HTML-Struktur ändern, wodurch der Parser beschädigt wird

• Der sitzungsbasierte Zugriff könnte gegen die Nutzungsbedingungen von Kagi verstoßen

• Eine Sperrung des Kontos oder ein dauerhafter Ausschluss ist möglich

• Der Endpunkt für die Zusammenfassung ist intern und kann sich ohne Vorankündigung ändern

• Die Nutzung erfolgt auf eigenes Risiko. Die Autoren übernehmen keine Haftung für Konsequenzen, einschließlich, aber nicht beschränkt auf Maßnahmen, die Kagi gegen Konten ergreift.

Lizenz

MIT