Kagi Session2API MCPサーバー

無料のKagi検索MCP（Model Context Protocol）サーバーです。公式APIキーを必要とせず、セッショントークンを使用してKagi検索と要約機能にアクセスできます。Claude Desktop、Cursor、Windsurf、Cline、Hermes、およびMCP互換のAIコーディングアシスタントやエージェントで動作します。

English | 中文文档

⚠️ エンドユーザーへの警告: このプロジェクトは、公式の有料APIを使用せずに検索および要約機能にアクセスするためにKagiセッショントークンを使用します。これはKagiの利用規約に違反する可能性があります。アカウントの停止や永久追放などの結果を招く恐れがあります。自己責任で使用してください。 著者は、Kagiによって取られたいかなるアカウント措置に対しても責任を負いません。

⚠️ セキュリティ警告: Kagiセッショントークンはアカウントへのフルアクセス権を提供します。パスワードのように扱ってください。決して共有したり、バージョン管理システムにコミットしたりしないでください。

機能

• セッションベースのアクセス: 公式API（$25/1000クエリ）の代わりにKagiセッショントークンを使用するため、完全に無料です。

• マルチトークンプール: 複数のトークンを設定してラウンドロビン方式でローテーションさせることで、スループットを向上させます。

• トークンごとのレート制限: トークンバケットアルゴリズムにより、トークンあたり5リクエスト/秒に制限されます。

• API互換の出力: 公式の kagimcp と同じ形式で結果を返します。

• 2つのツール: kagi_search_fetch（ウェブ検索）および kagi_summarizer（URL要約）

• Firefox UAスプーフィング: セッションベースのアクセスのために、本物のFirefoxブラウザを模倣します。

• 期限切れトークンの自動無効化: 期限切れのトークンは自動的に検出され、スキップされます。

• 検索演算子: Kagiの演算子（site:, lang:, filetype: など）をサポートしています。

対応プラットフォーム

MCP互換のあらゆるクライアントで動作します：

• Claude Desktop

• Cursor

• Windsurf

• Cline

• Hermes Agent

• stdio または HTTP トランスポートをサポートするすべてのMCPクライアント

クイックインストール（AIエージェント向け）

AIエージェントに以下のプロンプトを貼り付けてください：

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={THIS_PART}&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