赫尔墨斯搜索MCP服务器 🔍

🔌 与Cline、Cursor、Claude桌面版以及其他任何MCP客户端兼容！

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

赫尔墨斯搜索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

赫尔墨斯搜索示例

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