Azure AI Search MCP Server
Model Context Protocol Servers for Azure AI Search
Overview
Azure AI Search MCP Server is a Model Context Protocol (MCP) server that integrates with Azure AI Search, allowing Claude Desktop to query search indexes using keyword, vector, or hybrid methods.
To use the server, set up your project directory, create a .env file with your Azure Search credentials, set up a virtual environment, install dependencies, and configure Claude Desktop to recognize the MCP server.
- Seamless integration with Claude Desktop and Azure AI Search. - Supports multiple search methods: keyword, vector, and hybrid searches. - Customizable for additional tools and search logic modifications.
- Searching for specific information in Azure Search indexes.
- Utilizing semantic similarity for more relevant search results.
- Combining different search methods for enhanced query capabilities.
Add to your AI client
Use these steps to connect Azure AI Search MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-server-azure-ai-search-farzad528": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-azure-ai-search-farzad528"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-server-azure-ai-search-farzad528": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-azure-ai-search-farzad528"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-server-azure-ai-search-farzad528": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-azure-ai-search-farzad528"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-server-azure-ai-search-farzad528": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-azure-ai-search-farzad528"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-azure-ai-search-farzad528": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-azure-ai-search-farzad528"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-server-azure-ai-search-farzad528": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-server-azure-ai-search-farzad528"
]
}
}
}FAQ
**What programming language is used?**
The server is implemented in Python, requiring version 3.10 or higher.
**What are the system requirements?**
You need Azure AI Search Service configured with an index, Claude Desktop, and either Windows or macOS.
**How can I troubleshoot issues?**
Check Claude Desktop logs, verify file paths and environment variables, and test running the server directly.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2870,"uuid":"d0a80751-5c2f-4d91-b34d-417216d2ddcd","name":"mcp-server-azure-ai-search","title":"Azure AI Search MCP Server","description":"Model Context Protocol Servers for Azure AI Search","avatar_url":"https://avatars.githubusercontent.com/u/40604067?v=4","created_at":"2025-03-15T13:58:01.668Z","updated_at":"2025-03-15T14:14:25.766Z","status":"created","author_name":"farzad528","author_avatar_url":"https://avatars.githubusercontent.com/u/40604067?v=4","tags":"mcp-server,azure-ai-search,search-integration","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/farzad528/mcp-server-azure-ai-search","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/farzad528/mcp-server-azure-ai-search/raw/main/images/demo.gif","type":null,"metadata":"{\"star\":\"1\",\"license\":\"View license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-15 08:35:43\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]