Mrunmays Exa MCP Server

🚀 Exa MCP サーバー 🔍

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

デモビデオ

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

🚀 クイックスタート

Exa MCP サーバーを使用することで、Claude などの AI アシスタントがウェブ検索を行えるようになります。以下の手順に従って、サーバーをセットアップしましょう。

✨ 主な機能

• ウェブ検索ツール：Claude が自然言語クエリを使用してウェブを検索できます。
• エラー処理：API エラーやレート制限を適切に処理します。
• 型安全：完全な TypeScript 実装で、全面的な型チェックが行われます。

📦 インストール

前提条件

• Node.js：最新バージョンの Node.js と npm がインストールされていることを確認してください。
• Claude Desktop：Claude Desktop がインストールされ、実行されている必要があります。
• Exa API キー：Exa アカウントに登録し、有効な API キーを取得してください。

インストール方法

1. NPM を使用したインストール

npm install -g exa-mcp-server

2. Smithery を使用したインストール

smithery add exa

3. 手動インストール

1. ソースコードパッケージをダウンロードして解凍します。
2. プロジェクトディレクトリに移動し、以下のコマンドを実行します。

   npm install
   

📚 ドキュメント

設定ガイド

Claude 設定ファイルの編集

claude_desktop_config.json ファイルを見つけるか作成し、以下の内容を追加します。

{
  "mcp": {
    "servers": [
      {
        "name": "exa_mcp",
        "type": "custom",
        "uri": "localhost:1234",
        "api_key": "your_exa_api_key_here"
      }
    ]
  }
}

使用ガイド

サンプルクエリ

- テクノロジーニュースの検索：`What's the latest news about AI?`
- 技術文書の検索：`Find me the documentation for Node.js v18`

ワークフロー

1. 検索リクエストの処理
2. Exa API の呼び出し
3. フォーマットされた結果を Claude に返す
4. 検索結果のキャッシュ

🔧 技術詳細

機能の特長

• ウェブ検索：自然言語クエリをサポートします。
• エラー回復：スマートなリトライメカニズムがあります。
• レート制限：API のレート制限を自動的に処理します。

トラブルシューティング

一般的な問題

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

   • npm リンクが正しく設定されていることを確認してください。
   • Claude 設定ファイルの構文をチェックしてください。
   • Node.js が正しくインストールされていることを確認してください。

2. API キーの問題

   • API キーが有効であることを確認してください。
   • キーが正しく設定されていることをチェックしてください。
   • キーに空白や引用符がないことを確認してください。

3. 接続問題

   • Claude Desktop を完全に再起動してください。
   • ログを確認します。

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

ヘルプの取得

MCP ドキュメントを参照してください。

📄 ライセンス

このプロジェクトは、以下のサポートを受けています。

• Exa AI：強力な検索 API を提供しています。
• Model Context Protocol：MCP 標準を定義しています。
• Anthropic：Claude Desktop を開発しています。