Hermes搜索MCP服务器🔍
🔌 兼容Cline、Cursor、Claude Desktop和任何其他MCP客户端！
模型上下文协议（MCP）是一个开放标准，使人工智能系统能够与各种数据源和工具无缝交互，促进安全的双向连接。
Hermes Search MCP服务器提供：
- 结构化/非结构化数据的全文和语义搜索功能
- Azure认知搜索中的文档索引和管理
- 具有可定制参数的高效搜索操作
- 使用TypeScript进行类型安全操作
先决条件🔧
在开始之前，请确保您已经：
- Azure认知搜索服务和凭据
- 克劳德桌面或光标
- Node.js（v20或更高版本）
- Git已安装（仅在使用Git安装方法时需要）
Hermes Search MCP服务器安装⚡
使用NPX运行
npx -y hermes-search-mcp@latest通过Smithery安装
要通过Smithery自动安装Hermes Search MCP Server for Claude Desktop，请执行以下操作：
npx -y @smithery/cli install @hermes-search/mcp --client claude配置MCP客户端⚙️
配置Cline🤖
在Cline中设置Hermes Search MCP服务器的最简单方法是单击一下市场：
- 在VS代码中打开Cline
- 点击侧边栏中的Cline图标
- 导航到“MCP服务器”选项卡（4个方块）
- 搜索“Hermes搜索”并点击“安装”
- 出现提示时，输入您的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搜索服务器配置添加到文件中：
{
"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”） - 类型：选择“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搜索服务器配置：
{
"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搜索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安装 npm --version - 检查Claude Desktop配置语法 - 通过运行以下命令确保Node.js已正确安装 node --version
- Azure搜索凭据问题
- 确认您的Azure认知搜索凭据有效 - 检查配置中是否正确设置了凭据 - 验证凭据周围没有空格或引号
- 索引访问问题
- 验证索引是否存在于Azure认知搜索服务中 - 检查索引权限 - 确保API密钥具有适当的访问权限
致谢✨
- MCP规范的模型上下文协议
- 克劳德桌面的拟人化
- 微软Azure认知搜索