Hermes Search (Azure Cognitive Search)

1. Log in to the Azure Portal

   • Go to https://portal.azure.com/ and sign in with your Microsoft account.

2. Navigate to Azure Cognitive Search

   • In the portal search bar, type “Cognitive Search” and select “Azure Cognitive Search.”
   • Select your existing Cognitive Search resource, or create one if needed.

3. Obtain the Azure Search Endpoint

   • On your Cognitive Search resource overview page, find "URL" or "Endpoint."
   • Copy the value; it will look like: https://<your-service-name>.search.windows.net
   • This is your AZURE_SEARCH_ENDPOINT.

4. Generate or Retrieve the Azure Search API Key

   • In your Cognitive Search resource menu, go to “Keys.”
   • You’ll find “Admin keys” and “Query keys.” Use one of the "Admin keys" for full access.
   • Click the "copy" icon to copy either key.
   • This is your AZURE_SEARCH_API_KEY.

5. Choose/Create the Azure Search Index Name

   • In the resource menu, click “Indexes.”
   • Use the name of an existing index or click “+ Add Index” to create a new one.
   • The “Name” field value is your AZURE_SEARCH_INDEX_NAME.

6. Add Values to FastMCP

   • In the FastMCP connection interface, find the “Install Now” (ENV setup) button for hermes-search-mcp.
   • Enter the following:
     • AZURE_SEARCH_ENDPOINT: (paste your copied endpoint URL)
     • AZURE_SEARCH_API_KEY: (paste your copied key)
     • AZURE_SEARCH_INDEX_NAME: (enter your chosen index name)

7. Save and Confirm

   • Save your environment variable setup and restart your MCP client or server as required.

Your Azure Search MCP integration is now ready to use!