Exa

🚀 Exa MCP サーバーの使用 🔍

この Model Context Protocol (MCP) サーバーは、AI アシスタント（Claude など）が Exa の強力なウェブ検索 API を使用できるようにします。この設定により、AI モデルは安全かつ制御された方法でリアルタイムのウェブ情報を取得できます。

デモビデオ loom.com

🚀 クイックスタート

この Exa MCP サーバーを使用することで、AI アシスタントが Exa の検索 API を利用してウェブ検索を行えるようになります。以下に詳細な手順を説明します。

✨ 主な機能

• AI アシスタントが Exa の強力な検索 API を使用してウェブ検索を実行できるようにする
• タイトル、URL、内容の抜粋を含む構造化された検索結果を提供する
• 最近の検索をキャッシュして参照できるようにする
• レート制限とエラー状況を処理する
• 最新の内容を取得するためのリアルタイムウェブクローリングをサポートする

📋 前提条件

サーバーを使用する前に、以下のものが必要です。

• Node.js (v18 以上)
• Claude Desktop がインストールされていること
• Exa API キー
• npm がインストールされていること

📦 インストール

以下の手順でサーバーをインストールして設定します。

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

   git clone https://github.com/yourusername/exa-mcp-server.git
   cd exa-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. 環境変数を設定します。

   • .env ファイルを作成し、以下の内容を追加します。

     EXA_API_KEY=あなたのExa APIキー
     

4. サーバーを起動します。

   npm start
   

💻 使用例

基本的な使用法

サーバーが起動したら、Claude Desktop は MCP プロトコルを介してサーバーと通信できます。Claude で以下のコマンドを使用して検索を行うことができます。

{
  "command": "search",
  "query": "あなたの検索語"
}

サーバーはリクエストを処理し、構造化された検索結果を返します。

📚 ドキュメント

機能の詳細

• 簡素化されたウェブ検索ツール：Claude がクエリパラメータを使用して直接ウェブ検索を行えるようにする
• カスタマイズ可能な検索パラメータ：結果の数とリアルタイムクローリング戦略を制御する
• 自動リアルタイムクローリング：指定された戦略に基づいてリアルタイムクローリングを使用する
• 事前設定された最適なパラメータ：デフォルト値を使用して最適な結果を得る
• 検索キャッシュ：最近の検索を保存して参照できるようにする
• エラー処理：API エラーとレート制限を適切に処理する
• 型安全：Zod 検証を備えた完全な TypeScript 実装
• MCP 準拠：最新の MCP プロトコル仕様を完全に実装する

MCP チェッカーを使用したテスト

MCP チェッカーを使用してサーバーを直接テストすることができます。

npx @modelcontextprotocol/inspector node ./build/index.js

これにより、サーバーの機能を探索し、検索クエリを実行し、キャッシュされた検索結果を表示できるインタラクティブなインターフェイスが開きます。

🔧 技術詳細

トラブルシューティング

一般的な問題

1. サーバーが見つからない場合

   • npm リンクが正しく設定されていることを確認します。
   • Claude Desktop の設定構文が正しいことを確認します。
   • Node.js が正しくインストールされていることを確認します。

2. API キーの問題

   • あなたの EXA_API_KEY が有効であることを確認します。
   • Claude Desktop で API キーが正しく設定されていることを確認します。
   • API キーに空白や引用符が含まれていないことを確認します。

3. 接続の問題

   • Claude Desktop を完全に再起動します。
   • Claude Desktop のログを確認します。

     # macOS
     tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
     
     # Windows
     type "%APPDATA%\Claude\logs\mcp*.log"
     

ヘルプの取得

問題が発生した場合は、MCP ドキュメント を参照するか、GitHub ディスカッション でコミュニティのサポートを求めてください。

📄 ライセンス

謝辞

• Exa AI が強力な検索 API を提供しています。
• Model Context Protocol が MCP 仕様を提供しています。
• Anthropic が Claude Desktop を提供しています。