Kagi MCP Server

🚀 Kagi 搜索代理服务器（Node.js）

このプロジェクトは、Node.js を用いて実装された Kagi 検索代理サーバーです。Kagi 検索 API を使用して、AI アシスタントにウェブ検索機能を提供します。

✨ 主な機能

• Kagi API を使用したウェブ検索
• マルチスレッドクエリのサポート
• 検索結果のフォーマット
• TypeScript と公式 MCP SDK で構築
• 事前構築済みですぐに使用可能（構築手順不要）
• 他の MCP サーバーとの衝突を避けるための独自のツール名 (kagi_web_search)

📦 インストール

⚠️ 重要提示

まず、検索 API へのアクセス権を持っていることを確認してください。現在この機能はクローズドテスト段階であり、事前申請が必要です。support@kagi.com まで連絡して招待を取得してください。

前提条件

• Node.js 18 以上
• Kagi API キー

クイックスタート（インストール不要）

npx を使って直接サーバーを実行できます。

KAGI_API_KEY=あなたの_api_キー npx github:elliottlawson/kagi-mcp-server

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/elliottlawson/kagi-mcp-server.git
cd kagi-mcp-server

2. 直接実行（構築不要）

KAGI_API_KEY=あなたの_api_キー node build/index.js

コードを変更する場合は、依存関係をインストールして再構築する必要があります。

npm install
npm run build

Claude Desktop での設定

Claude Desktop の設定に以下の MCP 設定を追加します。

{
  "mcpServers": {
    "kagi": {
      "command": "npx",
      "args": ["github:elliottlawson/kagi-mcp-server"],
      "env": {
        "KAGI_API_KEY": "あなたの_api_キー"
      }
    }
  }
}

または、リポジトリをクローンした場合

{
  "mcpServers": {
    "kagi": {
      "command": "node",
      "args": ["リポジトリの絶対パス/build/index.js"],
      "env": {
        "KAGI_API_KEY": "あなたの_api_キー"
      }
    }
  }
}

Cursor での設定

1. Cursor の設定 -> MCP -> 新しい MCP サーバーを追加
2. MCP を設定します。
   • 名前：Kagi 検索
   • タイプ：コマンド
   • コマンド：npx github:elliottlawson/kagi-mcp-server
   • 環境変数：KAGI_API_KEY=あなたの_api_キー

AI アシスタントを使った検索質問の例

Kagi 検索代理サーバーはどのようにしてオンライン情報を検索するのに役立ちますか？

🔧 デバッグガイド

MCP Inspector ツールを使ってデバッグします。

# ツールのインストール：npm install -g @kagi/mcp-inspector
# デバッグの開始：mcp-inspector

Inspector で環境変数を追加します。

• 上部メニューバーの Edit -> Configuration をクリック
• KAGI_API_KEY 変数を追加し、値にあなたの API キーを設定

🔧 開発ガイド

プロジェクト構造

src/
├── server.ts      # メインサーバーファイル
└── search.ts     # 検索機能の実装
build/             # 構築出力ディレクトリ

構築と実行

npm run build    # プロジェクトの構築
npm start        # 構築後の成果物を実行

📄 注意事項

• サーバーは標準入出力を通じて通信します。
• ログレベルは環境変数 LOG_LEVEL で調整でき、デフォルトは info です。
• ツール名 kagi_web_search は MCP クライアントの設定と一致するようにしてください。