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 インストール方法を使用する場合のみ必要)

Related MCP server: Azure AI Search MCP Server

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 回のクリックでセットアップすることです。

1. VS CodeでClineを開く

2. サイドバーのClineアイコンをクリックします

3. 「MCPサーバー」タブ（4つの四角）に移動します

4. 「Hermes Search」を検索し、「インストール」をクリックします

5. プロンプトが表示されたら、Azure Cognitive Search の資格情報を入力します。

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

1. 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

2. 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": []
    }
  }
}

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

カーソルの設定 🖥️

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

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

1. カーソル設定を開く

2. 機能 > MCP サーバーに移動します

3. 「+新しいMCPサーバーを追加」ボタンをクリックします。

4. 以下の情報を入力してください。

   • 名前: サーバーのニックネームを入力します（例：「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ツールが表示されます。

エルメスの検索例

1. ドキュメントを検索:

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

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

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

3. インデックスを削除:

Delete the current Azure Cognitive Search index.

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

よくある問題

1. サーバーが見つかりません

   • npm --versionを実行して npm のインストールを確認します。

   • Claude Desktop の設定構文を確認する

   • node --versionを実行して Node.js が正しくインストールされていることを確認します。

2. Azure Search 資格情報の問題

   • Azure Cognitive Search の資格情報が有効であることを確認します

   • 構成で資格情報が正しく設定されていることを確認します

   • 資格情報の周囲にスペースや引用符がないことを確認してください

3. インデックスアクセスの問題

   • Azure Cognitive Search サービスにインデックスが存在することを確認する

   • インデックスの権限を確認する

   • APIキーに適切なアクセス権があることを確認する

謝辞✨

• MCP仕様のモデルコンテキストプロトコル

• クロード・デスクトップのAnthropic

• コグニティブサーチのための Microsoft Azure