Azure AI Agent Service + Azure AI Search MCP Server
by farzad528
A Model Context Protocol (MCP) server that enables Claude Desktop to search your content using Azure AI services. Choose between Azure AI Agent Service (with both document search and web search) or direct Azure AI Search integration.
Last updated: N/A
What is Azure AI Agent Service + Azure AI Search MCP Server?
This project provides two MCP server implementations to connect Claude Desktop with Azure search capabilities: Azure AI Agent Service (recommended) and direct Azure AI Search integration.
How to use Azure AI Agent Service + Azure AI Search MCP Server?
The README provides detailed setup guides for both the Azure AI Agent Service and direct Azure AI Search implementations, including environment variable configuration, dependency installation, and Claude Desktop configuration. Follow the steps outlined in the respective sections to set up and configure the server based on your chosen approach.
Key features of Azure AI Agent Service + Azure AI Search MCP Server
AI-Enhanced Search
Multiple Data Sources
Source Citations
Flexible Implementation
Seamless Claude Integration
Customizable
Use cases of Azure AI Agent Service + Azure AI Search MCP Server
Searching indexed documents with AI-enhanced results in Claude Desktop.
Searching the web with source citations in Claude Desktop.
Integrating Claude Desktop with Azure AI Search using keyword, vector, or hybrid search.
Customizing search behavior and integrating additional tools to enhance Claude Desktop's search capabilities.
FAQ from Azure AI Agent Service + Azure AI Search MCP Server
How do I troubleshoot if the server is not appearing in Claude Desktop?
How do I troubleshoot if the server is not appearing in Claude Desktop?
Check Claude Desktop logs, verify file paths and environment variables in the configuration, and test running the server directly using python azure_ai_agent_service_server.py or uv run python azure_ai_agent_service_server.py.
What should I do if I encounter issues with the Azure AI Agent Service?
What should I do if I encounter issues with the Azure AI Agent Service?
Ensure your Azure AI Project is correctly configured, verify that connections exist and are properly configured, and check your Azure authentication status.
Can I customize the search behavior of the server?
Can I customize the search behavior of the server?
Yes, you can modify tool instructions, add new tools using the @mcp.tool() decorator, customize response formatting, and adjust web search parameters.
What are the requirements for using this server?
What are the requirements for using this server?
You need Python 3.10 or higher, the latest version of Claude Desktop, Azure AI Search service with an index, and for Agent Service, an Azure AI Project with Azure AI Search and Bing connections. The operating system should be Windows or macOS.
Which implementation is recommended?
Which implementation is recommended?
The Azure AI Agent Service implementation is recommended as it uses the powerful Azure AI Agent Service to provide AI-enhanced search results and web search with source citations.