Exa MCP Server

🚀 Exa MCP サーバー 🔍

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

🚀 クイックスタート

Exa MCP サーバーは、AI アシスタントにウェブ検索機能を提供するための MCP サーバーです。このサーバーを使用することで、Claude などの AI モデルが安全にリアルタイム情報を取得できます。

✨ 主な機能

• ウェブ検索ツール：Claude が自然言語クエリを使ってウェブ検索を行えるようにします。
• エラー処理：API エラーやレート制限を適切に処理します。
• 型安全：完全な TypeScript 実装で、全面的な型チェックが可能です。
• 内容フィルタリング：不適切または敏感な情報を自動的にフィルタリングします。
• 結果ソート：結果を関連性に基づいてソートします。
• 多言語対応：複数の言語の検索リクエストに対応しています。

📦 インストール

前提条件

• Node.js：最新バージョンの Node.js と npm がインストールされていることを確認してください。
• Claude Desktop：最新バージョンの Claude Desktop をダウンロードしてインストールしてください。
• Exa API キー：有効な Exa API アクセスキーを取得してください。

インストール方法

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

npm install exa-mcp-server

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

smithery add exa

手動インストール

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

   git clone https://github.com/your-repository/exa-mcp.git
   

2. ディレクトリに移動し、依存関係をインストールします：

   cd exa-mcp
   npm install
   

📚 ドキュメント

設定ガイド

Claude Desktop の設定

Claude Settings に以下の設定を追加して、Exa MCP サーバーを認識させます：

{
  "mcpServers": [
    {
      "name": "Exa Search",
      "type": "SEARCH_API",
      "url": "http://localhost:3000"
    }
  ]
}

環境変数の設定

以下の環境変数を設定して、Exa MCP サーバーを構成します：

export EXA_API_KEY="your-api-key-here"

使用ガイド

基本的な使用法

Claude は以下のようにウェブ検索を実行できます：

const results = await exaMcp.search("如何学习人工智能");
// 構造化された結果を返す

処理フロー

1. 検索リクエストを分析します。
2. Exa API を呼び出して結果を取得します。
3. 結果をフォーマットして Claude に返します。
4. 検索結果をキャッシュして将来の使用に備えます。

トラブルシューティング

一般的な問題

1. サーバーが見つからない場合：
   • npm リンクが正しく設定されていることを確認してください。
   • Claude Desktop の設定構文を確認してください。
2. API キーの問題：
   • API キーが有効であることを確認してください。
   • キーが設定に正しく設定されていることを確認してください。

サポートの取得

さらなるサポートが必要な場合は、MCP ドキュメントを参照してください。

📄 ライセンス

このプロジェクトに関するライセンス情報は、元の README に記載がないため、このセクションは表示されません。

謝辞 🙏

• Exa AI：強力な検索 API を提供してくれました。
• モデルコンテキストプロトコル (MCP)：規格を策定してくれました。
• Anthropic：Claude Desktop を開発してくれました。