Hermes 搜索 MCP 服务器 🔍

🔌与 Cline、Cursor、Claude Desktop 和任何其他 MCP 客户端兼容！

模型上下文协议 (MCP) 是一种开放标准，使 AI 系统能够与各种数据源和工具无缝交互，促进安全的双向连接。

Hermes Search MCP 服务器提供：

对结构化/非结构化数据的全文和语义搜索功能
Azure 认知搜索中的文档索引和管理
具有可自定义参数的高效搜索操作
使用 TypeScript 进行类型安全操作

先决条件🔧

在开始之前，请确保您已：

Azure 认知搜索服务和凭据
Claude 桌面或光标
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 服务器的最简单方法是通过市场单击一下：

在 VS Code 中打开 Cline
点击侧边栏中的 Cline 图标
导航到“MCP 服务器”选项卡（4 个方块）
搜索“Hermes Search”，点击“安装”
出现提示时，输入 Azure 认知搜索凭据

或者，您可以在 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 已运行，请保存文件并重新启动它。

配置光标🖥️

注意：需要 Cursor 版本 0.45.6 或更高版本

要在 Cursor 中设置 Hermes Search MCP 服务器：

打开游标设置
导航至“功能”>“MCP 服务器”
点击“+ 添加新的 MCP 服务器”按钮
填写以下信息：
- 名称：输入服务器的昵称（例如，“hermes-search-mcp”）
- 类型：选择“命令”作为类型
- 命令：输入运行服务器的命令：GXP5
  重要提示：将环境变量替换为 Azure 认知搜索凭据

配置 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 工具。

Hermes 搜索示例

搜索文件：

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 搜索凭据问题
- 确认 Azure 认知搜索凭据有效
- 检查配置中的凭据是否正确设置
- 验证凭证周围没有空格或引号
索引访问问题
- 验证 Azure 认知搜索服务中是否存在索引
- 检查索引权限
- 确保 API 密钥具有适当的访问权限

致谢✨

MCP 规范的模型上下文协议
克劳德桌面版的 Anthropic
Microsoft Azure 认知搜索