Hermes Search (Azure Cognitive Search)

🚀 赫尔墨斯搜索MCP服务器 🔍

赫尔墨斯搜索MCP服务器与模型上下文协议（MCP）紧密结合，MCP作为开放标准，能让AI系统与各类数据源和工具无缝交互，实现安全的双向连接。本服务器可与Cline、Cursor、Claude桌面版以及其他任何MCP客户端兼容，具备全文本和语义搜索等功能，为数据搜索和管理提供强大支持。

🚀 快速开始

在使用赫尔墨斯搜索MCP服务器之前，您需要做好一些准备工作，确保具备以下条件：

• Azure认知搜索服务及凭证
• Claude桌面版或Cursor
• Node.js（v20或更高版本）
• Git安装（仅用于Git安装方法）

✨ 主要特性

• 提供全文本和语义搜索功能，可处理结构化和非结构化数据。
• 支持在Azure认知搜索中的文档索引和管理。
• 搜索操作高效，且参数可自定义。
• 操作具备类型安全，使用TypeScript实现。

📦 安装指南

使用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认知搜索凭证。

方式二：手动设置

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

💻 使用示例

基础用法

搜索文档

在Azure认知搜索索引中查找包含“机器学习”的文档，返回前10个结果。

索引内容

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

删除索引

删除当前的Azure认知搜索索引。

🛠️ 故障排除

常见问题

服务器未找到

• 验证npm安装情况，运行npm --version。
• 检查Claude桌面版配置语法。
• 确保Node.js正确安装，运行node --version。

Azure搜索凭证问题

• 确认您的Azure认知搜索凭证有效。
• 检查凭证是否正确设置在配置中。
• 确保凭证没有空格或引号。

索引访问问题

• 确认索引存在于您的Azure认知搜索服务中。
• 检查索引权限。
• 确保API密钥具有适当的访问权限。