Exa MCP Server 🔍

Exa MCP サーバー 🔍

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

デモ動画 https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60

MCP とは？ 🤔

Model Context Protocol（MCP）は、Claude Desktop のような AI アプリが外部のツールやデータソースに接続できるようにするシステムです。ユーザーが制御権を保ちながら、AI アシスタントがローカルサービスや API を利用するための、明確で安全な方法を提供します。

このサーバーでできること 🚀

Exa MCP サーバーは、次の機能を提供します。

• AI アシスタントが Exa の強力な検索 API を使ってウェブ検索を実行できるようにします
• タイトル、URL、コンテンツの抜粋など、構造化された検索結果を提供します
• レート制限やエラー発生時にも適切に対応します

前提条件 📋

始める前に、次のものがそろっていることを確認してください。

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

次のコマンドを実行すると、Node.js がインストールされていることを確認できます。

node --version  # Should show v18.0.0 or higher

インストール 🛠️

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

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

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

npm install --save axios dotenv

3. プロジェクトをビルドします。

npm run build

4. グローバルリンクを作成します（これにより、どこからでもサーバーを実行できるようになります）。

npm link

設定 ⚙️

1. Claude Desktop の設定

Claude Desktop が Exa MCP サーバーを認識できるように設定します。

claude_desktop_config.json は、Claude Desktop アプリの設定画面でも確認できます。

または

macOS の場合：

1. Claude Desktop の設定ファイルを開きます。

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合：

1. Claude Desktop の設定ファイルを開きます。

code %APPDATA%\Claude\claude_desktop_config.json

2. Exa サーバーの設定を追加します。

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": ["/path/to/exa-mcp-server/build/index.js"],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

your-api-key-here を、dashboard.exa.ai/api-keys で取得した実際の Exa API キーに置き換えてください。

2. Claude Desktop を再起動する

変更を反映するには、次の手順を実行します。

1. Claude Desktop を完全に終了します（ウィンドウを閉じるだけでは不十分です）

2. Claude Desktop を再び起動します

3. 🔌 アイコンを確認し、Exa サーバーが接続されていることを確認します

使い方 🎯

設定が完了すると、Claude にウェブ検索を依頼できます。プロンプトの例を以下に示します。

Can you search for recent developments in quantum computing?

Search for and summarize the latest news about artificial intelligence startups in new york.

Find and analyze recent research papers about climate change solutions.

サーバーは次の処理を行います。

1. 検索リクエストを処理します

2. Exa API に問い合わせます

3. 形式を整えた結果を Claude に返します

4. 今後参照できるよう、検索結果をキャッシュします

機能 ✨

• ウェブ検索ツール：自然言語のクエリを使ったウェブ検索を Claude が実行できるようにします

• エラー処理：API エラーやレート制限に適切に対応します

• 型安全性：適切な型チェックを備えた、完全な TypeScript 実装です

トラブルシューティング 🔧

よくある問題

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

   • npm のリンクが正しく設定されていることを確認します

   • Claude Desktop の設定構文を確認します

   • Node.js が正しくインストールされていることを確認します

2. API キーの問題

   • Exa API キーが有効であることを確認します

   • Claude Desktop の設定ファイルに API キーが正しく設定されていることを確認します

   • API キーの前後にスペースや引用符がないことを確認します

3. 接続の問題

   • Claude Desktop を完全に再起動します

   • Claude Desktop のログを確認します。

     # macOS
     tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
     

ヘルプを得る

問題が発生した場合は、MCP のドキュメントを確認してください。

謝辞 🙏

• 強力な検索 API を提供する Exa AI に感謝します

• MCP 仕様を提供する Model Context Protocol に感謝します

• Claude Desktop を提供する Anthropic に感謝します