Exa

Exa MCP Server 🔍

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 サーバーは次の機能を提供します。

• Exa の強力な検索 API を使った AI アシスタントのウェブ検索を可能にします
• タイトル、URL、コンテンツの抜粋を含む、構造化された検索結果を提供します
• 最近の検索を、参照用のリソースとしてキャッシュします
• レート制限やエラーに適切に対処します
• 最新のコンテンツを取得するリアルタイムのウェブクロールに対応します

前提条件 📋

開始する前に、以下を用意してください。

• Node.js（v18 以降）
• Claude Desktop のインストール
• Exa API キー
• Git のインストール

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

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

インストール 🛠️

NPM でのインストール

npm install -g exa-mcp-server

Smithery を使用する

Smithery を使って、Claude Desktop 用の Exa MCP サーバーを自動的にインストールするには：

npx -y @smithery/cli install exa --client claude

手動インストール

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

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

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

npm install

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

npm run build

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

npm link

設定 ⚙️

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

Claude Desktop アプリの設定内に claude_desktop_config.json があります。

Claude Desktop アプリを開き、左上のメニューバーから Developer Mode を有効にします。

有効にしたら、左上のメニューバーから Settings を開き、Developer Option に移動します。Edit Config ボタンをクリックすると claude_desktop_config.json ファイルが開き、必要な編集を行えます。

または（ターミナルから claude_desktop_config.json を開く場合）

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 キーに置き換えます。

3. 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.

Search for today's breaking news about tech.

Search for the top 10 AI research papers from 2023, and only use live crawling as a fallback.

Search for electric vehicles and return 3 results, always using live crawling.

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

1. 検索リクエストを処理します
2. 最適な設定（ライブクロールを含む）で Exa API に問い合わせます
3. 書式を整えた結果を Claude に返します
4. 今後の参照に備えて検索をキャッシュします

機能 ✨

• シンプルなウェブ検索ツール：Claude がクエリパラメーターだけでウェブ検索できるようにします
• カスタマイズ可能な検索パラメーター：結果の件数とリアルタイムクロールの戦略を設定できます
• 自動リアルタイムクロール：指定した戦略に基づいてリアルタイムでクロールします
• 最適なパラメーターをあらかじめ設定：結果件数と文字数制限に最適なデフォルト値を使用します
• 検索キャッシュ：最近の検索を参照用のリソースとして保存します
• エラー処理：API エラーやレート制限を適切に処理します
• 型安全性：Zod による検証を備えた、完全な TypeScript 実装です
• MCP 準拠：最新の MCP プロトコル仕様を完全に実装しています

MCP Inspector でのテスト 🔍

MCP Inspector を使って、サーバーを直接テストできます：

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

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

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

よくある問題

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

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

2. API キーの問題

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

3. 接続の問題

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

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

サポートを受ける

問題が発生した場合は、MCP Documentationを確認するか、コミュニティのサポートを受けるためにGitHub discussionsをご覧ください。

謝辞 🙏

• 強力な検索 API を提供する Exa AI
• MCP 仕様を提供する Model Context Protocol
• Claude Desktop を提供する Anthropic