Exa MCP Server

MIT License
1,858
  • Apple

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 デスクトップ アプリの設定内にあります。

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. 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. 将来の参照のために検索をキャッシュする

特徴 ✨

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

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 のログを確認する: GXP18

ヘルプの取得

問題が発生した場合は、 MCP ドキュメントを確認するか、 GitHub のディスカッションにアクセスしてコミュニティ サポートを受けてください。

謝辞🙏

-
security - not tested
A
license - permissive license
-
quality - not tested

Claude のような AI アシスタントが Exa AI Search API を使用して Web 検索を実行できるようにし、安全かつ制御された方法でリアルタイムの 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. Restart Claude Desktop
        3. Usage 🎯
          1. Features ✨
            1. Testing with MCP Inspector 🔍
              1. Troubleshooting 🔧
                1. Common Issues
                2. Getting Help
              2. Acknowledgments 🙏
                ID: pcaft49gu3