MCPサーバ - Exaのソースを表示

== 概要 ==
Exa MCP Server (exa-labs/exa-mcp-server) は、Model Context Protocol (MCP) を通じてAIアシスタントにExa検索APIの機能を統合するサーバである。<br>
Exa Labsが開発・提供するオープンソースプロジェクトであり、MITライセンスの下で公開されている。<br>
<br>
対応クライアントは、Claude Desktop、Claude Code、OpenCode、Cursor、VS Code、Windsurf、Zed、Gemini CLI、v0 by Vercel、Warp、Roo Code等、多数のMCPクライアントに対応する。<br>
<br>
ホストMCPサーバ (https://mcp.exa.ai/mcp) または npmパッケージとして利用可能であり、APIキー不要で無料利用を開始できる。<br>
オプションでExa APIキーを追加することで、より高度な機能を利用できる。<br>
<br>
主な特徴は以下の通りである。<br>
* MCP標準に準拠したWeb検索インターフェース
* ホストMCPサーバによるセットアップ不要の導入
* Web検索、コード検索、企業調査、学術論文検索、ピープルサーチ等の多機能ツール
* Deep Researcher機能による詳細なリサーチレポート生成
* URLパラメータによる柔軟なツール選択
* Windows、MacOS、Linuxの主要なOSで動作
<br><br>

== 提供ツール ==
==== デフォルト有効ツール ====
ツール指定なしの場合、<code>web_search_exa</code> と <code>get_code_context_exa</code> がデフォルトで有効になる。<br>
<br>
下表に、デフォルトで有効なツールの一覧を示す。<br>
<br>
<center>
{| class="wikitable"
|+ デフォルト有効ツール一覧
! ツール名 !! 説明
|-
| web_search_exa || 一般的なWeb検索を行い、クリーンで利用可能なコンテンツを返す。<br>日付フィルタに対応する。
|-
| get_code_context_exa || GitHub、Stack Overflow、技術ドキュメントからプログラミングソリューションを検索する。<br>数十億のGitHubリポジトリを検索対象とする。
|-
| company_research_exa || 企業調査およびニュースリサーチを行う。<br>企業Webサイトをクロールして詳細情報、資金調達データ、チーム情報等を収集する。
|}
</center>
<br>
==== デフォルト無効ツール ====
以下に示すツールはデフォルトで無効になっており、URLパラメータ <code>?tools=</code> で有効化できる。<br>
<br>
<center>
{| class="wikitable"
|+ デフォルト無効ツール一覧
! ツール名 !! 説明
|-
| web_search_advanced_exa || Exa検索の全パラメータを使用可能な高度なWeb検索<br>カテゴリフィルタ、ドメイン制限、日付範囲、テキストフィルタリング、ハイライト、サマリー、サブページクローリングに対応する。
|-
| crawling_exa || 既知URLの完全なWebページコンテンツを取得する。
|-
| people_search_exa || LinkedInプロフィールおよび職務経歴情報を検索する。
|-
| linkedin_search_exa || 企業および個人のLinkedIn情報を検索する。
|-
| deep_researcher_start || 詳細なリサーチレポート作成タスクを開始する。<br>タスクIDを返す。
|-
| deep_researcher_check || deep_researcher_startで開始したリサーチタスクの完了状態を確認し、レポートを取得する。
|}
</center>
<br>
==== 検索カテゴリ ====
下表に、<code>web_search_advanced_exa</code> で使用可能なカテゴリを示す。<br>
<br>
<center>
{| class="wikitable"
|+ 検索カテゴリ一覧
! カテゴリ !! 説明
|-
| financial report || 金融レポート (SEC申請書、決算データ)
|-
| research papers || 研究論文 (arXiv、学術雑誌)
|-
| personal site || 個人サイトおよびブログ
|-
| people || ピープルサーチ
|-
| company || 企業情報
|-
| news || ニュース記事
|-
| tweet || ツイートおよびスレッド
|}
</center>
<br><br>

== 動作要件 ==
==== 共通の要件 ====
OS問わず共通して必要な要件を以下に示す。<br>
<br>
* インターネット接続
* MCPに対応したクライアント (Claude Desktop、Claude Code、OpenCode等)
<br>
ホストMCPサーバを使用する場合、ローカルにNode.js等のセットアップは不要である。<br>
<br>
npmパッケージを使用する場合は、以下が追加で必要になる。<br>
* Node.js
*: <code>npx</code> コマンドが使用可能であること。
* Exa APIキー
*: https://dashboard.exa.ai/api-keys から取得する。
<br><br>

== APIキーの取得 ==
Exa APIキーを取得するには、以下に示す手順を実行する。<br>
<br>
# https://dashboard.exa.ai/api-keys にアクセスする。
# サイドバーから[API Keys]を選択する、
# [Create API Key]を選択する。
# キー名を入力して、[Create]を選択する。
# 表示されたAPIキーをコピーして安全に保管する。(表示は1度のみ)
<br>
APIキーのセキュリティに関する注意事項は以下の通りである。<br>
* <u>.envファイル</u> に保存して、<u>.gitignoreファイル</u> に追加してバージョン管理の対象外にする。
* 設定ファイルにAPIキーをハードコードしない。
* 定期的にダッシュボードから新しいキーを生成してキーをローテーションする。
<br><br>

== インストール ==
==== ホストMCPサーバを使用する場合 (推奨) ====
Exa公式が提供するホストMCPサーバを使用する方法である。<br>
URLのみで設定が完了するため、ローカルにNode.jsのセットアップが不要である。<br>
<br>
* サーバURL
*: https://mcp.exa.ai/mcp
* APIキーを指定する場合
*: https://mcp.exa.ai/mcp?exaApiKey=<ExaのAPIキー>
<br>
==== npmパッケージを使用する場合 ====
ローカル環境でnpmパッケージを実行する方法である。<br>
<br>
npxで実行する場合は以下のコマンドを使用する。<br>
<br>
 npx exa-mcp-server
<br>
グローバルインストールする場合は以下のコマンドを実行する。<br>
<br>
 npm install -g exa-mcp-server
<br>
利用可能なツールの一覧を表示する。<br>
<br>
 npx exa-mcp-server --list-tools
<br><br>

== 設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。<br>
<br>
Claude Desktopの設定ファイルを以下に示す。<br>
* Windows
*: <u>%APPDATA%\Claude\claude_desktop_config.json</u>
* MacOS
*: <u>~/Library/Application Support/Claude/claude_desktop_config.json</u>
* Linux
*: <u>~/.config/Claude/claude_desktop_config.json</u>
<br>
Claude Codeの設定ファイルを以下に示す。<br>
* Windows
*: <u>%APPDATA%\claude\settings.json</u>
* MacOS
*: <u>~/Library/Application Support/claude/settings.json</u>
* Linux
*: <u>~/.config/claude/settings.json</u>
<br>
OpenCodeの設定ファイルを以下に示す。<br>
* グローバル設定
*: <u>~/.config/opencode/opencode.json</u>
* プロジェクト設定
*: <u>/<プロジェクトルート>/opencode.json</u>
<br>
==== Claude Desktopでの設定 ====
Claude Desktopの設定ファイルに以下の内容を追記する。<br>
<br>
* ホストMCPサーバを使用する場合 (推奨)、mcp-remote経由で接続する。
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "exa": {
       "command": "npx",
       "args": ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"]
     }
   }
 }
 </syntaxhighlight>
*: <br>
* npmパッケージを直接実行する場合
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "exa": {
       "command": "npx",
       "args": ["-y", "exa-mcp-server"],
       "env": {
         "EXA_API_KEY": "<APIキー>"
       }
     }
   }
 }
 </syntaxhighlight>
<br>
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。<br>
<br>
==== Claude Codeでの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してMCPサーバを追加できる。<br>
<br>
CLIコマンドでMCPサーバを追加する場合は以下のコマンドを実行する。<br>
<br>
 # ホストMCPサーバ (推奨)
 claude mcp add --transport http exa https://mcp.exa.ai/mcp
 
 # ツール指定版
 claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_advanced_exa,crawling_exa"
 
 # npmパッケージ版
 claude mcp add -e EXA_API_KEY=<ExaのAPIキー> -- npx -y exa-mcp-server
<br>
設定ファイルに直接記述する場合は以下の内容を追記する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "exa": {
       "command": "npx",
       "args": ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== OpenCodeでの設定 ====
* OpenCodeの設定ファイルにリモートMCPサーバとして設定する場合 (推奨)
*: <syntaxhighlight lang="json">
 {
   "mcp": {
     "exa": {
       "type": "remote",
       "url": "https://mcp.exa.ai/mcp",
       "enabled": true
     }
   }
 }
 </syntaxhighlight>
*: <br>
* npmパッケージをローカルで実行する場合
*: <syntaxhighlight lang="json">
 {
   "mcp": {
     "exa": {
       "type": "local",
       "command": "npx",
       "args": ["-y", "exa-mcp-server"],
       "env": {
         "EXA_API_KEY": "<APIキー>"
       },
       "enabled": true
     }
   }
 }
 </syntaxhighlight>
*: <br>
* CLIコマンドを使用する場合
*: <syntaxhighlight lang="text">
 opencode mcp add exa --url https://mcp.exa.ai/mcp
 </syntaxhighlight>
<br>
OpenCodeはリモートMCPサーバに対して自動的にOAuth認証を処理する。<br>
<br>
==== 特定ツールの有効化 ====
URLパラメータ <code>?tools=</code> を使用して有効にするツールをカンマ区切りで選択できる。<br>
<br>
* 特定ツールを指定する場合
*: <syntaxhighlight lang="text">
 https://mcp.exa.ai/mcp?tools=web_search_exa,crawling_exa,company_research_exa
 </syntaxhighlight>
*: <br>
* 全ツールを有効化する場合
*: <syntaxhighlight lang="text">
 https://mcp.exa.ai/mcp?tools=web_search_exa,get_code_context_exa,company_research_exa,web_search_advanced_exa,crawling_exa,people_search_exa,linkedin_search_exa,deep_researcher_start,deep_researcher_check
 </syntaxhighlight>
<br>
==== 環境変数の設定 ====
npmパッケージを使用する場合、Exa APIキーを環境変数として設定する必要がある。<br>
<br>
* <u>.envファイル</u> で設定する場合
*: <syntaxhighlight lang="text">
 EXA_API_KEY=<APIキー>
 </syntaxhighlight>
*: <br>
* Linux / MacOSで設定する場合
*: <syntaxhighlight lang="sh">
 export EXA_API_KEY="<APIキー>"
 </syntaxhighlight>
*: <br>
* Windowsで設定する場合
** PowerShellを使用する場合
**: <syntaxhighlight lang="powershell">
 $env:EXA_API_KEY = "<APIキー>"
 </syntaxhighlight>
**: <br>
** コマンドプロンプトを使用する場合
**: <syntaxhighlight lang="text">
 set EXA_API_KEY=<APIキー>
 </syntaxhighlight>
<br><br>

== 使用方法 ==
各ツールはAIアシスタントが自然言語の指示を受けて自動的に呼び出す。<br>
<br>
==== Web検索 ====
* Web空最新情報を検索する場合のプロンプト例
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 React 19の最新機能について検索してください。
 </syntaxhighlight>
<br>
==== コード検索 ====
* プログラミングソリューションを検索する場合のプロンプト例
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 Node.jsでOAuth 2.0認証を実装するコード例を探してください。
 </syntaxhighlight>
<br>
==== 企業調査 ====
* 企業の詳細情報を収集する場合のプロンプト例
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 Stripeの企業情報、資金調達履歴、最新ニュースをリサーチしてください。
 </syntaxhighlight>
<br>
==== Webページクローリング ====
既知URLのページ内容を取得する場合のプロンプト例を以下に示す。<br>
<br>
* 特定URLのページ内容を取得する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 https://example.com/docs のページ内容を取得してください。
 </syntaxhighlight>
<br>
==== Deep Researcher ====
Deep Researcherは非同期ジョブベースのパターンで動作する。<br>
<br>
動作の流れは以下の通りである。<br>
<br>
# <u>deep_researcher_start</u> でリサーチタスクを開始する。
# タスクIDを取得する。
# <u>deep_researcher_check</u> でタスクの完了状態を確認する。
# 完了後、リサーチレポートを取得する。
<br>
詳細なリサーチレポートを作成する場合のプロンプト例を以下に示す。<br>
<br>
* 特定テーマの詳細リサーチを依頼する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 量子コンピューティングスタートアップの最新動向について、詳細なリサーチレポートを作成してください。
 </syntaxhighlight>
<br><br>

== その他 ==
==== 制約事項 ====
===== テキストフィルタの制限事項 =====
* <code>includeText</code> および <code>excludeText</code> パラメータは単一項目の配列のみ対応する。(複数項目は400エラー)
* テキストフィルタは最大5単語まで
* <code>people</code> カテゴリでは <code>includeText</code> / <code>excludeText</code> 使用不可
<br>
===== カテゴリ別フィルタの制限事項 =====
<code>company</code> カテゴリ使用時の制限:<br>
* <code>includeDomains</code> / <code>excludeDomains</code> は使用不可
* 日付フィルタ (<code>startPublishedDate</code> 等) は使用不可
<br>
<code>financial report</code> カテゴリ使用時の制限:<br>
* <code>excludeText</code> は使用不可
<br>
==== 関連リンク ====
* [https://exa.ai/mcp Exa MCP Server公式ページ]
* [https://github.com/exa-labs/exa-mcp-server GitHubリポジトリ]
* [https://dashboard.exa.ai/api-keys Exa APIダッシュボード]
* [https://exa.ai/docs/reference/exa-mcp Exa MCP公式ドキュメント]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Exa,MCP,Model Context Protocol,Exa MCP Server,exa-mcp-server,Search API,Web Search,Code Search,Company Research,Deep Researcher,Claude,Claude Desktop,Claude Code,OpenCode,AI,検索,Web検索,コード検索,企業調査
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]