Hermes Search (Azure Cognitive Search)

🚀 赫爾墨斯搜索MCP服務器 🔍

赫爾墨斯搜索MCP服務器基於模型上下文協議（MCP）這一開放標準構建，能讓AI系統與各種數據源和工具無縫交互，實現安全的雙向連接。它具備全文本和語義搜索等功能，可高效處理結構化與非結構化數據。

🚀 快速開始

模型上下文協議（MCP）是一個開放標準，使AI系統能夠無縫交互各種數據源和工具，實現安全的雙向連接。赫爾墨斯搜索MCP服務器與Cline、Cursor、Claude桌面版以及其他任何MCP客戶端兼容！

✨ 主要特性

• 全文本和語義搜索功能，適用於結構化/非結構化數據
• 在Azure認知搜索中的文檔索引和管理
• 高效的搜索操作，帶有可自定義的參數
• 類型安全的操作，使用TypeScript

📦 安裝指南

prerequisites 🔧

開始之前，請確保您有：

• Azure認知搜索服務及憑證
• Claude桌面版或Cursor
• Node.js（v20或更高版本）
• Git安裝（僅用於Git安裝方法）

赫爾墨斯搜索MCP服務器安裝 ⚡

使用NPX運行

npx -y hermes-search-mcp@latest

通過Smithery安裝

要自動通過Smithery為Claude桌面版安裝赫爾墨斯搜索MCP服務器：

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

⚙️ 配置MCP客戶端

配置Cline 🤖

在Cline中設置赫爾墨斯搜索MCP服務器最簡單的方式是通過市場單擊：

1. 在VS Code中打開Cline。
2. 點擊左側邊欄的Cline圖標。
3. 轉到“MCP服務器”選項卡（四個方塊）。
4. 搜索“Hermes Search”並點擊“安裝”。
5. 出現提示時，輸入您的Azure認知搜索憑證。

或者，您也可以手動在Cline中設置赫爾墨斯搜索MCP服務器：

1. 打開Cline MCP設置文件：

# 適用於macOS：
code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# 適用於Windows：
code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

2. 將赫爾墨斯搜索MCP服務器配置添加到文件中：

{
  "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（如果它已經在運行）。

配置Cursor 🖥️

⚠️ 重要提示

需要Cursor版本0.45.6或更高。

要在Cursor中設置赫爾墨斯搜索MCP服務器：

1. 打開Cursor設置。
2. 轉到功能 > MCP服務器。
3. 點擊“+添加新的MCP服務器”按鈕。
4. 填寫以下信息：
   • 名稱：為您的MCP服務器輸入一個名稱。
   • 命令：hermes-search-mcp
5. 完成後，點擊“完成”。

配置Claude桌面版 🛑

1. 打開Claude桌面版的設置。
2. 轉到“集成”部分。
3. 添加新的MCP服務器：
   • 名稱：hermes-search-mcp
   • 命令：npx hermes-search-mcp

💻 使用示例

基礎用法

以下是赫爾墨斯搜索MCP服務器的一些使用示例：

1. 搜索文檔：

在Azure認知搜索索引中查找包含“機器學習”的文檔，返回前10個結果。

2. 索引內容：

將以下文檔索引到Azure認知搜索：[{"id": "1", "title": "AI概述", "content": "人工智能是..."}]

3. 刪除索引：

刪除當前的Azure認知搜索索引。

🛠️ 故障排除

常見問題

1. 服務器未找到
   • 驗證npm安裝情況，運行npm --version。
   • 檢查Claude桌面版配置語法。
   • 確保Node.js正確安裝，運行node --version。
2. Azure搜索憑證問題
   • 確認您的Azure認知搜索憑證有效。
   • 檢查憑證是否正確設置在配置中。
   • 確保憑證沒有空格或引號。
3. 索引訪問問題
   • 確認索引存在於您的Azure認知搜索服務中。
   • 檢查索引權限。
   • 確保API密鑰具有適當的訪問權限。