Exa MCP Server

Official
MIT License
1,858
510
  • Apple

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Exa MCP サーバー 🔍

モデルコンテキストプロトコル(MCP)サーバーにより、ClaudeのようなAIアシスタントはExa AI Search APIを使用してWeb検索を行うことができます。この設定により、AIモデルは安全かつ制御された方法でリアルタイムのWeb情報を取得できます。

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

MCPとは何ですか?🤔

モデルコンテキストプロトコル(MCP)は、Claude DesktopのようなAIアプリが外部ツールやデータソースに接続できるようにするシステムです。これにより、AIアシスタントがユーザーの制御を維持しながら、ローカルサービスやAPIを明確かつ安全に操作できるようになります。

このサーバーは何をしますか?🚀

Exa MCP サーバー:

  • Exaの強力な検索APIを使用してAIアシスタントがWeb検索を実行できるようにします
  • タイトル、URL、コンテンツスニペットを含む構造化された検索結果を提供します
  • 最近の検索を参照用のリソースとしてキャッシュします
  • レート制限とエラーケースを適切に処理します
  • 最新のコンテンツをリアルタイムでクロールする機能をサポート

前提条件 📋

始める前に、次のものを用意してください。

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

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

インストール 🛠️

NPMのインストール

npm install -g exa-mcp-server

鍛冶屋を使う

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
  1. 依存関係をインストールします:
npm install
  1. プロジェクトをビルドします。
npm run build
  1. グローバル リンクを作成します (これにより、サーバーはどこからでも実行可能になります)。
npm link

設定 ⚙️

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

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

Claude デスクトップ アプリを開き、左上のメニュー バーから開発者モードを有効にします。

有効にしたら、設定(左上のメニューバーから)を開き、開発者向けオプションに移動します。そこに「設定を編集」ボタンがあります。これをクリックすると、claude_desktop_config.jsonファイルが開き、必要な編集を行うことができます。

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

macOSの場合:

  1. Claude デスクトップ構成を開きます。
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windowsの場合:

  1. Claude デスクトップ構成を開きます。
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 : 最適化された結果とコンテンツの抽出を使用して、リアルタイムの Web 検索を実行します。
  • research_paper_search : 学術論文や研究内容に焦点を当てた専門的な検索。
  • twitter_search : ツイート、プロフィール、会話を検索する専用の Twitter/X.com 検索。
  • company_research : 企業の Web サイトをクロールして、ビジネスに関する詳細な情報を収集する包括的な企業調査ツール。
  • クロール: 特定の URL からコンテンツを抽出します。正確な URL がわかっている場合に、記事、PDF、または任意の Web ページを読むのに役立ちます。
  • compete_finder : 同様の製品やサービスを提供している企業を検索して、企業の競合他社を特定します。

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

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

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

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

{ "mcpServers": { "exa": { "command": "npx", "args": [ "/path/to/exa-mcp-server/build/index.js", "--tools=web_search,research_paper_search,twitter_search,company_research,crawling,competitor_finder" ], "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 # Enable multiple tools npx exa-mcp-server --tools=web_search,research_paper_search # List all available tools npx exa-mcp-server --list-tools

使用方法 🎯

設定が完了したら、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 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.

サーバーは次のことを行います。

  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が有効であることを確認してください
    • Claude Desktop の設定で EXA_API_KEY が正しく設定されていることを確認します。
    • APIキーの周囲にスペースや引用符がないことを確認してください
  3. 接続の問題
    • Claude Desktopを完全に再起動します
    • Claude Desktop のログを確認する: GXP23

謝辞🙏

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

モデルコンテキストプロトコル(MCP)サーバーにより、ClaudeのようなAIアシスタントはExa AI Search APIを使用してWeb検索を行うことができます。この設定により、AIモデルは安全かつ制御された方法でリアルタイムのWeb情報を取得できます。

  1. What is MCP? 🤔
    1. What does this server do? 🚀
      1. Prerequisites 📋
        1. Installation 🛠️
          1. NPM Installation
          2. Using Smithery
          3. Manual Installation
        2. Configuration ⚙️
          1. 1. Configure Claude Desktop to recognize the Exa MCP server
          2. 2. Add the Exa server configuration:
          3. 3. Available Tools & Tool Selection
          4. 4. Restart Claude Desktop
        3. Using via NPX
          1. Usage 🎯
            1. Testing with MCP Inspector 🔍
              1. Troubleshooting 🔧
                1. Common Issues
              2. Acknowledgments 🙏
                ID: 8gfe5kbp5y