MCP Servers Kagi

🚀 Kagi サーバー MCP サーバー

Kagi API を統合した MCP サーバーです。このサーバーは、TypeScript をベースに構築され、Kagi 検索 API を統合しています。核心的な MCP 概念を実装することで、その機能を展示します。

• Kagi を使用したウェブ検索やその他の操作を行うツール
  • クエリ文字列とオプションの制限パラメータを提供
  • 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

セキュリティを保つために、.env を .gitignore ファイルに追加してください。

📦 インストール

Smithery を通じたインストール

Smithery を通じて Claude Desktop 用の Kagi Server を自動インストールするには、以下のコマンドを実行します。

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 サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。MCP Inspector を使用することをおすすめします。これはパッケージスクリプトとして提供されています。

npm run inspector

Inspector はブラウザのデバッグツールにアクセスするための URL を提供します。

💻 使用例

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

1. Claude に「量子計算の最新の進展について検索してくれますか？」と尋ねます。
2. Claude は kagi_search ツールを使用して Kagi の API から結果を取得します。
3. Claude は検索結果を要約または分析します。

注意：予定されているツール（要約、fastgpt、enrich）は未実装であり、使用できません。

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。貢献できる分野は以下の通りです。

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

📄 ライセンス

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

🗺️ ロードマップ

• kagi_summarize ツールを実装して、ウェブページとテキストの要約を行う
• kagi_fastgpt ツールを実装して、迅速な応答を取得する
• kagi_enrich ツールを実装して、豊富なニュース結果を取得する
• エラー処理を改善し、より堅牢な入力検証を追加する
• より包括的な使用例とドキュメントを追加する
• npm に公開して、Claude Desktop と npx で簡単にインストールできるようにする