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

インストール 🛠️

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. Exa MCP サーバーを認識するように Claude Desktop を設定する

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. 利用可能なツールとツールの選択

Exa MCP サーバーには、次のツールが含まれています。

• web_search_exa：最適化された検索結果とコンテンツ抽出を利用して、リアルタイムのウェブ検索を実行します。
• research_paper_search：学術論文や研究コンテンツに特化した検索を行います。
• twitter_search：ツイート、プロフィール、会話を検索する、Twitter/X.com 専用の検索です。
• company_research：企業のウェブサイトをクロールし、企業に関する詳細情報を収集する包括的な企業調査ツールです。
• crawling：特定の URL からコンテンツを抽出します。正確な URL が分かっている記事、PDF、その他のウェブページを読むのに便利です。
• competitor_finder：類似した製品やサービスを提供する企業を検索し、ある企業の競合他社を特定します。
• linkedin_search：Exa AI を使って LinkedIn の企業や人物を検索します。クエリに企業名、人物名、または特定の LinkedIn URL を含めるだけです。

Claude Desktop の設定に --tools パラメーターを追加すると、有効にするツールを選択できます。

有効にするツールを指定します：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "/path/to/exa-mcp-server/build/index.js",
        "--tools=web_search_exa,research_paper_search,twitter_search,company_research,crawling,competitor_finder,linkedin_search"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

複数のツールを有効にする場合は、カンマ区切りのリストを使用します：

{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": [
        "/path/to/exa-mcp-server/build/index.js",
        "--tools=web_search_exa,research_paper_search,twitter_search,company_research,crawling,competitor_finder,linkedin_search"
      ],
      "env": {
        "EXA_API_KEY": "your-api-key-here"
      }
    }
  }
}

ツールを指定しない場合、デフォルトで有効になっているすべてのツールが使用されます。

4. Claude Desktop を再起動します

変更を反映するには：

1. Claude Desktop を完全に終了します（ウィンドウを閉じるだけではありません）
2. Claude Desktop を再度起動します
3. 🔌 アイコンを確認し、Exa サーバーが接続されていることを確認します

NPX 経由での使用

サーバーを直接実行する場合は、npx を使用できます：

# Run with all tools enabled by default
npx exa-mcp-server

# Enable specific tools only
npx exa-mcp-server --tools=web_search_exa

# Enable multiple tools
npx exa-mcp-server --tools=web_search_exa,research_paper_search

# List all available tools
npx exa-mcp-server --list-tools

使用方法 🎯

設定が完了したら、Claude にウェブ検索を依頼できます。プロンプトの例をいくつか紹介します：

Can you search for recent developments in quantum computing?

Find and analyze recent research papers about climate change solutions.

Search Twitter for posts from @elonmusk about SpaceX.

Find tweets from @samaltman that were published in the last week about AI safety.

Research the company exa.ai and find information about their pricing and features.

Extract the content from this research paper: https://arxiv.org/pdf/1706.03762

Find competitors for a company that provides web search API services, excluding exa.ai from the results.

Find the LinkedIn profile for Anthropic company.

Search for data scientists at OpenAI on LinkedIn.

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

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

MCP Inspector によるテスト 🔍

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

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

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

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

よくある問題

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

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

2. API キーの問題

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

3. 接続の問題

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

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

謝辞 🙏

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