Hermes Search MCP 服务器 🔍

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

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

Hermes Search MCP 服务器提供：

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

先决条件 🔧

在开始之前，请确保您拥有以下内容：

• Azure 认知搜索服务和凭据
• Claude Desktop 或 Cursor
• Node.js (版本 20 或更高)
• 已安装 Git（仅当使用 Git 安装方法时需要）

Hermes Search MCP 服务器安装 ⚡

使用 NPX 运行

npx -y hermes-search-mcp@latest

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Hermes Search MCP 服务器：

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

配置 MCP 客户端 ⚙️

配置 Cline 🤖

在 Cline 中设置 Hermes Search MCP 服务器最简单的方法是通过市场一键安装：

1. 在 VS Code 中打开 Cline
2. 单击侧边栏中的 Cline 图标
3. 导航到 "MCP Servers" 标签页（4个方块）
4. 搜索 "Hermes Search" 并点击 "安装"
5. 当提示时，输入您的 Azure 认知搜索凭据

或者，您可以手动在 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

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

1. 保存文件。如果 Cline 已经运行，请重启 Cline。

配置 Cursor 🖥️

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

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

1. 打开 Cursor 设置
2. 导航到 Features > MCP Servers
3. 点击 "+ Add New MCP Server" 按钮
4. 填写以下信息：
   • 名称：为服务器输入一个昵称（例如 "hermes-search-mcp"）
   • 类型：选择 "command" 作为类型
   • 命令：输入运行服务器的命令：

   env AZURE_SEARCH_ENDPOINT=your-search-endpoint AZURE_SEARCH_API_KEY=your-api-key AZURE_SEARCH_INDEX_NAME=your-index-name npx -y hermes-search-mcp@latest
   

   重要：请用您的 Azure 认知搜索凭据替换环境变量

配置 Claude Desktop 应用程序 🖥️

对于 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 Desktop 应用程序中的使用 🎯

一旦完成安装并配置了 Claude 桌面应用程序，您必须完全关闭并重新打开 Claude 桌面应用程序才能看到 hermes-search-mcp 服务器。您应该会在应用程序左下角看到一个搜索图标，表明可用的 MCP 工具。

Hermes Search 示例

1. 搜索文档：

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

1. 索引内容：

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

1. 删除索引：

Delete the current Azure Cognitive Search index.

故障排除 🛠️

常见问题

1. 找不到服务器

   • 通过运行 npm --version 来验证 npm 安装
   • 检查 Claude Desktop 配置语法
   • 通过运行 node --version 确保 Node.js 已正确安装

2. Azure 搜索凭据问题

   • 确认您的 Azure 认知搜索凭据有效
   • 检查配置中是否正确设置了凭据
   • 确认凭据周围没有空格或引号

3. 索引访问问题

   • 确认您的 Azure 认知搜索服务中存在该索引
   • 检查索引权限
   • 确保证书具有适当的访问权限

致谢 ✨

• Model Context Protocol 为 MCP 规范
• Anthropic 为 Claude Desktop
• Microsoft Azure 为认知搜索