Hermes Search (Azure Cognitive Search)

🚀 Hermes Search MCP Server 🔍

Hermes Search MCP Server enables seamless interaction between AI systems and various data sources and tools through the Model Context Protocol (MCP)

🔌 Compatible with Cline, Cursor, Claude Desktop, and any other MCP clients!

The Model Context Protocol (MCP) is an open standard that enables AI systems to interact seamlessly with various data sources and tools, enabling secure two-way connections.

The Hermes Search MCP Server offers:

• Full-text and semantic search capabilities for structured/unstructured data
• Document indexing and management in Azure Cognitive Search
• Efficient search operations with customizable parameters
• Type-safe operations using TypeScript

🚀 Quick Start

🔧 Prerequisites

Before you begin, ensure you have the following:

• An Azure Cognitive Search service and its credentials
• Claude Desktop or Cursor
• Node.js (v20 or higher)
• Git installed (only required for the Git installation method)

📦 Installation

Run with NPX

npx -y hermes-search-mcp@latest

Install via Smithery

To automatically install the Hermes Search MCP Server for Claude Desktop via Smithery:

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

⚙️ Configure MCP Clients

Configure Cline 🤖

The easiest way to set up the Hermes Search MCP Server in Cline is by clicking through the marketplace:

1. Open Cline in VS Code.
2. Click the Cline icon on the left sidebar.
3. Go to the "MCP Servers" tab (four squares).
4. Search for "Hermes Search" and click "Install".
5. When prompted, enter your Azure Cognitive Search credentials.

Alternatively, you can manually set up the Hermes Search MCP Server in Cline:

1. Open the Cline MCP settings file:

# 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

2. Add the Hermes Search MCP Server configuration to the file:

{
  "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. Save the file and restart Cline if it's already running.

Configure Cursor 🖥️

⚠️ Important Note

A Cursor version of 0.45.6 or higher is required.

To set up the Hermes Search MCP Server in Cursor:

1. Open Cursor settings.

2. Go to Features > MCP Servers.

3. Click the "+ Add New MCP Server" button.

4. Fill in the following information:

   • Name: Enter a name for your MCP server.
   • Command: hermes-search-mcp

5. Click "Done" when finished.

Configure Claude Desktop 🛑

1. Open the settings of Claude Desktop.
2. Go to the "Integrations" section.
3. Add a new MCP server:
   • Name: hermes-search-mcp
   • Command: npx hermes-search-mcp

💻 Usage Examples

Basic Usage

Search Documents

Find documents containing "machine learning" in the Azure Cognitive Search index and return the top 10 results.

Index Content

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

Delete Index

Delete the current Azure Cognitive Search index.

🔧 Troubleshooting

Common Issues

Server Not Found

• Verify the npm installation by running npm --version.
• Check the configuration syntax in Claude Desktop.
• Ensure Node.js is installed correctly by running node --version.

Azure Search Credential Issues

• Confirm that your Azure Cognitive Search credentials are valid.
• Check if the credentials are correctly set in the configuration.
• Ensure there are no spaces or quotes in the credentials.

Index Access Issues

• Confirm that the index exists in your Azure Cognitive Search service.
• Check the index permissions.
• Ensure that the API key has appropriate access permissions.