Hermes Search MCP サーバー 🔍

🔌 Cline、Cursor、Claude Desktop、その他の MCP クライアントと互換性があります。

モデルコンテキストプロトコル (MCP) は、AI システムがさまざまなデータソースやツールとシームレスに対話し、安全な双方向接続を実現できるようにするオープンスタンダードです。

Hermes Search MCP サーバーは以下を提供します。

構造化/非構造化データに対する全文検索およびセマンティック検索機能
Azure Cognitive Search におけるドキュメントのインデックス作成と管理
カスタマイズ可能なパラメータによる効率的な検索操作
TypeScriptによる型安全な操作

前提条件🔧

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

Azure Cognitive Search サービスと資格情報
クロードデスクトップまたはカーソル
Node.js (v20以上)
Git がインストールされている (Git インストール方法を使用する場合のみ必要)

Hermes Search MCP サーバーのインストール ⚡

NPXで実行

npx -y hermes-search-mcp@latest

Smithery経由でインストール

Smithery 経由で Claude Desktop 用の Hermes Search MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @hermes-search/mcp --client claude

MCP クライアントの設定 ⚙️

Cline の設定 🤖

Cline で Hermes Search MCP サーバーをセットアップする最も簡単な方法は、マーケットプレイスから 1 回のクリックでセットアップすることです。

VS CodeでClineを開く
サイドバーのClineアイコンをクリックします
「MCPサーバー」タブ（4つの四角）に移動します
「Hermes Search」を検索し、「インストール」をクリックします
プロンプトが表示されたら、Azure Cognitive Search の資格情報を入力します。

あるいは、Cline で Hermes Search MCP サーバーを手動で設定することもできます。

Cline MCP 設定ファイルを開きます。

# For macOS:
code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# For Windows:
code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

Hermes Search サーバーの構成をファイルに追加します。

{
  "mcpServers": {
    "hermes-search-mcp": {
      "command": "npx",
      "args": ["-y", "hermes-search-mcp@latest"],
      "env": {
        "AZURE_SEARCH_ENDPOINT": "your-search-endpoint",
        "AZURE_SEARCH_API_KEY": "your-api-key",
        "AZURE_SEARCH_INDEX_NAME": "your-index-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

ファイルを保存し、Cline がすでに実行されている場合は再起動します。

カーソルの設定 🖥️

注: カーソルバージョン0.45.6以上が必要です

Cursor で Hermes Search MCP サーバーを設定するには:

カーソル設定を開く
機能 > MCP サーバーに移動します
「+新しいMCPサーバーを追加」ボタンをクリックします。
以下の情報を入力してください。
- 名前: サーバーのニックネームを入力します（例：「hermes-search-mcp」）
- タイプ: タイプとして「コマンド」を選択
- コマンド: サーバーを実行するコマンドを入力してください: GXP5
  重要: 環境変数をAzure Cognitive Searchの資格情報に置き換えてください

Claude デスクトップアプリの設定 🖥️

macOSの場合:

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windowsの場合:

code %APPDATA%\Claude\claude_desktop_config.json

Hermes Search サーバーの構成を追加します。

{
  "mcpServers": {
    "hermes-search-mcp": {
      "command": "npx",
      "args": ["-y", "hermes-search-mcp@latest"],
      "env": {
        "AZURE_SEARCH_ENDPOINT": "your-search-endpoint",
        "AZURE_SEARCH_API_KEY": "your-api-key",
        "AZURE_SEARCH_INDEX_NAME": "your-index-name"
      }
    }
  }
}

Claude デスクトップアプリでの使用 🎯

インストールが完了し、Claudeデスクトップアプリの設定が完了したら、Claudeデスクトップアプリを完全に閉じて再度開くと、hermes-search-mcpサーバーが表示されます。アプリの左下に検索アイコンが表示され、利用可能なMCPツールが表示されます。

エルメスの検索例

ドキュメントを検索:

Search for documents containing "machine learning" in the Azure Cognitive Search index, returning the top 10 results.

インデックスコンテンツ:

Index the following documents into Azure Cognitive Search: [{"id": "1", "title": "AI Overview", "content": "Artificial Intelligence is..."}]

インデックスを削除:

Delete the current Azure Cognitive Search index.

トラブルシューティング 🛠️

よくある問題

サーバーが見つかりません
- npm --versionを実行して npm のインストールを確認します。
- Claude Desktop の設定構文を確認する
- node --versionを実行して Node.js が正しくインストールされていることを確認します。
Azure Search 資格情報の問題
- Azure Cognitive Search の資格情報が有効であることを確認します
- 構成で資格情報が正しく設定されていることを確認します
- 資格情報の周囲にスペースや引用符がないことを確認してください
インデックスアクセスの問題
- Azure Cognitive Search サービスにインデックスが存在することを確認する
- インデックスの権限を確認する
- APIキーに適切なアクセス権があることを確認する

謝辞✨

MCP仕様のモデルコンテキストプロトコル
クロード・デスクトップのAnthropic
コグニティブサーチのための Microsoft Azure