Model Context Protocol Servers for Azure AI Search
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add azure-ai-agent-service-azure-ai-search --env PROJECT_CONNECTION_STRING='<PROJECT_CONNECTION_STRING>' --env MODEL_DEPLOYMENT_NAME='<MODEL_DEPLOYMENT_NAME>' --env AI_SEARCH_CONNECTION_NAME='<AI_SEARCH_CONNECTION_NAME>' --env BING_CONNECTION_NAME='<BING_CONNECTION_NAME>' --env AI_SEARCH_INDEX_NAME='<AI_SEARCH_INDEX_NAME>' --env AZURE_SEARCH_API_KEY='<AZURE_SEARCH_API_KEY>' --env AZURE_SEARCH_INDEX_NAME='<AZURE_SEARCH_INDEX_NAME>' --env AZURE_SEARCH_SERVICE_ENDPOINT='<AZURE_SEARCH_SERVICE_ENDPOINT>' -- python azure_ai_agent_service_server.py~/.codex/config.toml
[mcp_servers.azure-ai-agent-service-azure-ai-search]
command = "python"
args = ["azure_ai_agent_service_server.py"]
env = { PROJECT_CONNECTION_STRING = "<PROJECT_CONNECTION_STRING>", MODEL_DEPLOYMENT_NAME = "<MODEL_DEPLOYMENT_NAME>", AI_SEARCH_CONNECTION_NAME = "<AI_SEARCH_CONNECTION_NAME>", BING_CONNECTION_NAME = "<BING_CONNECTION_NAME>", AI_SEARCH_INDEX_NAME = "<AI_SEARCH_INDEX_NAME>", AZURE_SEARCH_API_KEY = "<AZURE_SEARCH_API_KEY>", AZURE_SEARCH_INDEX_NAME = "<AZURE_SEARCH_INDEX_NAME>", AZURE_SEARCH_SERVICE_ENDPOINT = "<AZURE_SEARCH_SERVICE_ENDPOINT>" }
# codex mcp add azure-ai-agent-service-azure-ai-search --env PROJECT_CONNECTION_STRING='<PROJECT_CONNECTION_STRING>' --env MODEL_DEPLOYMENT_NAME='<MODEL_DEPLOYMENT_NAME>' --env AI_SEARCH_CONNECTION_NAME='<AI_SEARCH_CONNECTION_NAME>' --env BING_CONNECTION_NAME='<BING_CONNECTION_NAME>' --env AI_SEARCH_INDEX_NAME='<AI_SEARCH_INDEX_NAME>' --env AZURE_SEARCH_API_KEY='<AZURE_SEARCH_API_KEY>' --env AZURE_SEARCH_INDEX_NAME='<AZURE_SEARCH_INDEX_NAME>' --env AZURE_SEARCH_SERVICE_ENDPOINT='<AZURE_SEARCH_SERVICE_ENDPOINT>' -- python azure_ai_agent_service_server.py~/.cursor/mcp.json
{
"mcpServers": {
"azure-ai-agent-service-azure-ai-search": {
"command": "python",
"args": [
"azure_ai_agent_service_server.py"
],
"env": {
"PROJECT_CONNECTION_STRING": "<PROJECT_CONNECTION_STRING>",
"MODEL_DEPLOYMENT_NAME": "<MODEL_DEPLOYMENT_NAME>",
"AI_SEARCH_CONNECTION_NAME": "<AI_SEARCH_CONNECTION_NAME>",
"BING_CONNECTION_NAME": "<BING_CONNECTION_NAME>",
"AI_SEARCH_INDEX_NAME": "<AI_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_API_KEY": "<AZURE_SEARCH_API_KEY>",
"AZURE_SEARCH_INDEX_NAME": "<AZURE_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_SERVICE_ENDPOINT": "<AZURE_SEARCH_SERVICE_ENDPOINT>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"azure-ai-agent-service-azure-ai-search": {
"type": "stdio",
"command": "python",
"args": [
"azure_ai_agent_service_server.py"
],
"env": {
"PROJECT_CONNECTION_STRING": "<PROJECT_CONNECTION_STRING>",
"MODEL_DEPLOYMENT_NAME": "<MODEL_DEPLOYMENT_NAME>",
"AI_SEARCH_CONNECTION_NAME": "<AI_SEARCH_CONNECTION_NAME>",
"BING_CONNECTION_NAME": "<BING_CONNECTION_NAME>",
"AI_SEARCH_INDEX_NAME": "<AI_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_API_KEY": "<AZURE_SEARCH_API_KEY>",
"AZURE_SEARCH_INDEX_NAME": "<AZURE_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_SERVICE_ENDPOINT": "<AZURE_SEARCH_SERVICE_ENDPOINT>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"azure-ai-agent-service-azure-ai-search": {
"command": "python",
"args": [
"azure_ai_agent_service_server.py"
],
"env": {
"PROJECT_CONNECTION_STRING": "<PROJECT_CONNECTION_STRING>",
"MODEL_DEPLOYMENT_NAME": "<MODEL_DEPLOYMENT_NAME>",
"AI_SEARCH_CONNECTION_NAME": "<AI_SEARCH_CONNECTION_NAME>",
"BING_CONNECTION_NAME": "<BING_CONNECTION_NAME>",
"AI_SEARCH_INDEX_NAME": "<AI_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_API_KEY": "<AZURE_SEARCH_API_KEY>",
"AZURE_SEARCH_INDEX_NAME": "<AZURE_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_SERVICE_ENDPOINT": "<AZURE_SEARCH_SERVICE_ENDPOINT>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"azure-ai-agent-service-azure-ai-search": {
"command": "python",
"args": [
"azure_ai_agent_service_server.py"
],
"env": {
"PROJECT_CONNECTION_STRING": "<PROJECT_CONNECTION_STRING>",
"MODEL_DEPLOYMENT_NAME": "<MODEL_DEPLOYMENT_NAME>",
"AI_SEARCH_CONNECTION_NAME": "<AI_SEARCH_CONNECTION_NAME>",
"BING_CONNECTION_NAME": "<BING_CONNECTION_NAME>",
"AI_SEARCH_INDEX_NAME": "<AI_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_API_KEY": "<AZURE_SEARCH_API_KEY>",
"AZURE_SEARCH_INDEX_NAME": "<AZURE_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_SERVICE_ENDPOINT": "<AZURE_SEARCH_SERVICE_ENDPOINT>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"azure-ai-agent-service-azure-ai-search": {
"command": "python",
"args": [
"azure_ai_agent_service_server.py"
],
"env": {
"PROJECT_CONNECTION_STRING": "<PROJECT_CONNECTION_STRING>",
"MODEL_DEPLOYMENT_NAME": "<MODEL_DEPLOYMENT_NAME>",
"AI_SEARCH_CONNECTION_NAME": "<AI_SEARCH_CONNECTION_NAME>",
"BING_CONNECTION_NAME": "<BING_CONNECTION_NAME>",
"AI_SEARCH_INDEX_NAME": "<AI_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_API_KEY": "<AZURE_SEARCH_API_KEY>",
"AZURE_SEARCH_INDEX_NAME": "<AZURE_SEARCH_INDEX_NAME>",
"AZURE_SEARCH_SERVICE_ENDPOINT": "<AZURE_SEARCH_SERVICE_ENDPOINT>"
}
}
}
}Environment variables
PROJECT_CONNECTION_STRINGMODEL_DEPLOYMENT_NAMEAI_SEARCH_CONNECTION_NAMEBING_CONNECTION_NAMEAI_SEARCH_INDEX_NAMEAZURE_SEARCH_API_KEYAZURE_SEARCH_INDEX_NAMEAZURE_SEARCH_SERVICE_ENDPOINT
Replace the placeholders with your own credentials and keep them out of version control.