kagi-server MCP Server

kagi-server MCP サーバー

Kagi API と連携する MCP サーバー

Kagi Search API と連携する TypeScript ベースの MCP サーバーです。次の機能を提供し、MCP の基本概念を紹介します。

• Kagi の API を使用してウェブ検索などの操作を行うツール（現在はプライベートベータ版）

機能

実装済みのツール

• kagi_search - Kagi を使用してウェブ検索を行います
  • クエリ文字列と任意の上限数をパラメーターとして受け取ります
  • Kagi API の検索結果を返します

予定されているツール（未実装）

• kagi_summarize - ウェブページやテキストの要約を生成します
• kagi_fastgpt - Kagi の FastGPT を使用してすばやく回答を取得します
• kagi_enrich - 特定のトピックに関する拡充されたニュース結果を取得します

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

環境設定

ルートディレクトリに .env ファイルを作成し、Kagi API キーを設定します。

KAGI_API_KEY=your_api_key_here

API キーを安全に保つため、.env を .gitignore ファイルに追加してください。

インストール

Smithery 経由でインストールする

Smithery 経由で Kagi Server を Claude Desktop に自動インストールするには：

npx @smithery/cli install kagi-server --client claude

Claude Desktop で使用するには、サーバーの設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kagi-server": {
      "command": "/path/to/kagi-server/build/index.js",
      "env": {
        "KAGI_API_KEY": "your_api_key_here"
      }
    }
  }
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

npm run inspector

Inspector により、ブラウザーでデバッグツールにアクセスするための URL が表示されます。

使い方

サーバーを起動して Claude Desktop に接続したら、ウェブ検索に使用できます。たとえば：

1. Claude に「量子コンピューティングの最新の進歩について検索してもらえますか？」と尋ねます。
2. Claude は kagi_search ツールを使用して、Kagi API から結果を取得します。
3. Claude は取得した検索結果を要約または分析します。

注：予定されているツール（summarize、fastgpt、enrich）はまだ実装されていないため、使用できません。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。貢献できる分野の例を以下に示します。

• 予定されているツール（summarize、fastgpt、enrich）の実装
• エラー処理と入力検証の改善
• ドキュメントと使用例の充実

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

ロードマップ

• ウェブページやテキストの要約を行う kagi_summarize ツールを実装する
• すばやく回答を取得する kagi_fastgpt ツールを実装する
• 拡充されたニュース結果を取得する kagi_enrich ツールを実装する
• エラー処理を改善し、より堅牢な入力検証を追加する
• より包括的な使用例とドキュメントを追加する
• Claude Desktop および npx で簡単にインストールして使用できるよう、パッケージを npm に公開する