azure ai search.com
azure ai search.com logo

Azure AI Search

Integrates with Azure AI Search to enable keyword, vector, and hybrid search capabilities for retrieving information fro...

Created byApr 22, 2025

Azure AI Agent Service + Azure AI Search MCP Server

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.
demo

Overview

This project provides two MCP server implementations to connect Claude Desktop with Azure search capabilities:
  1. Azure AI Agent Service Implementation (Recommended) - Uses the powerful Azure AI Agent Service to provide:
  1. Direct Azure AI Search Implementation - Connects directly to Azure AI Search with three methods:

Features

  • AI-Enhanced Search - Azure AI Agent Service optimizes search results with intelligent processing
  • Multiple Data Sources - Search both your private documents and the public web
  • Source Citations - Web search results include citations to original sources
  • Flexible Implementation - Choose between Azure AI Agent Service or direct Azure AI Search integration
  • Seamless Claude Integration - All search capabilities accessible through Claude Desktop's interface
  • Customizable - Easy to extend or modify search behavior

Quick Links


Requirements

  • Python: Version 3.10 or higher
  • Claude Desktop: Latest version
  • Azure Resources:
  • Operating System: Windows or macOS (instructions provided for Windows, but adaptable)

Azure AI Agent Service Implementation (Recommended)

Setup Guide

  1. Project Directory:
  1. Create a `.env` File:
  1. Set Up Virtual Environment:
  1. Use the `azure_ai_agent_service_server.py` script for integration with Azure AI Agent Service.

Azure AI Agent Service Setup

Before using the implementation, you need to:
  1. Create an Azure AI Project:
  1. Create an Azure AI Search Connection:
  1. Create a Bing Web Search Connection:
  1. Authenticate with Azure:

Configuring Claude Desktop

Note: Replace path placeholders with your actual project paths.

Direct Azure AI Search Implementation

For those who prefer direct Azure AI Search integration without the Agent Service:
  1. Create a different `.env` File:
  1. Install Dependencies:
  1. Use the `azure_search_server.py` script for direct integration with Azure AI Search.
  1. Configure Claude Desktop:

Testing the Server

  1. Restart Claude Desktop to load the new configuration
  1. Look for the MCP tools icon (hammer icon) in the bottom-right of the input field
  1. Try queries such as:

Troubleshooting

  • Server Not Appearing:
  • Azure AI Agent Service Issues:

Customizing Your Server

  • Modify Tool Instructions: Adjust the instructions provided to each agent to change how they process queries
  • Add New Tools: Use the @mcp.tool() decorator to integrate additional tools
  • Customize Response Formatting: Edit how responses are formatted and returned to Claude Desktop
  • Adjust Web Search Parameters: Modify the web search tool to focus on specific domains

License

This project is licensed under the MIT License.

Azure AI Agent Service + Azure AI Search MCP Server

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.
demo

Overview

This project provides two MCP server implementations to connect Claude Desktop with Azure search capabilities:
  1. Azure AI Agent Service Implementation (Recommended) - Uses the powerful Azure AI Agent Service to provide:
  1. Direct Azure AI Search Implementation - Connects directly to Azure AI Search with three methods:

Features

  • AI-Enhanced Search - Azure AI Agent Service optimizes search results with intelligent processing
  • Multiple Data Sources - Search both your private documents and the public web
  • Source Citations - Web search results include citations to original sources
  • Flexible Implementation - Choose between Azure AI Agent Service or direct Azure AI Search integration
  • Seamless Claude Integration - All search capabilities accessible through Claude Desktop's interface
  • Customizable - Easy to extend or modify search behavior

Quick Links


Requirements

  • Python: Version 3.10 or higher
  • Claude Desktop: Latest version
  • Azure Resources:
  • Operating System: Windows or macOS (instructions provided for Windows, but adaptable)

Azure AI Agent Service Implementation (Recommended)

Setup Guide

  1. Project Directory:
  1. Create a `.env` File:
  1. Set Up Virtual Environment:
  1. Use the `azure_ai_agent_service_server.py` script for integration with Azure AI Agent Service.

Azure AI Agent Service Setup

Before using the implementation, you need to:
  1. Create an Azure AI Project:
  1. Create an Azure AI Search Connection:
  1. Create a Bing Web Search Connection:
  1. Authenticate with Azure:

Configuring Claude Desktop

Note: Replace path placeholders with your actual project paths.

Direct Azure AI Search Implementation

For those who prefer direct Azure AI Search integration without the Agent Service:
  1. Create a different `.env` File:
  1. Install Dependencies:
  1. Use the `azure_search_server.py` script for direct integration with Azure AI Search.
  1. Configure Claude Desktop:

Testing the Server

  1. Restart Claude Desktop to load the new configuration
  1. Look for the MCP tools icon (hammer icon) in the bottom-right of the input field
  1. Try queries such as:

Troubleshooting

  • Server Not Appearing:
  • Azure AI Agent Service Issues:

Customizing Your Server

  • Modify Tool Instructions: Adjust the instructions provided to each agent to change how they process queries
  • Add New Tools: Use the @mcp.tool() decorator to integrate additional tools
  • Customize Response Formatting: Edit how responses are formatted and returned to Claude Desktop
  • Adjust Web Search Parameters: Modify the web search tool to focus on specific domains

License

This project is licensed under the MIT License.