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密钥具有适当的访问权限。