Azure AI Search MCP Server

概述

Azure AI Search MCP 服务器将 Claude Desktop 与 Azure AI Search 连接起来，支持三种搜索方法：关键词搜索、向量搜索和混合搜索。

前提条件

• Python 3.10+
• Azure AI Search 服务（已配置索引）
• Claude Desktop 最新版本
• Windows 或 macOS

设置步骤

1. 创建项目

mkdir mcp-server-azure-ai-search
cd mcp-server-azure-ai-search

2. 配置环境变量

创建 .env 文件：

AZURE_SEARCH_SERVICE_ENDPOINT=https://your-service-name.search.windows.net
AZURE_SEARCH_INDEX_NAME=your-index-name
AZURE_SEARCH_API_KEY=your-api-key

3. 设置虚拟环境

uv venv
.venv\Scripts\activate  # Windows
# 或 source .venv/bin/activate  # macOS/Linux

uv pip install "mcp[cli]" azure-search-documents==11.5.2 azure-identity python-dotenv

4. 创建服务器脚本

创建 azure_search_server.py 文件，实现:

• 从 .env 加载配置
• 初始化 Azure AI Search 客户端
• 定义搜索功能并注册为 MCP 工具

5. 配置 Claude Desktop

1. 打开 Claude Desktop
2. 导航至: 设置 > 开发者 > 编辑配置
3. 添加配置:

{
  "mcpServers": {
    "azure-search": {
      "command": "C:\\path\\to\\mcp-server-azure-ai-search\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\mcp-server-azure-ai-search\\azure_search_server.py"],
      "env": {
        "AZURE_SEARCH_SERVICE_ENDPOINT": "https://your-service-name.search.windows.net",
        "AZURE_SEARCH_INDEX_NAME": "your-index-name",
        "AZURE_SEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

注意: 替换路径为您的实际项目路径

6. 测试服务器

1. 重启 Claude Desktop
2. 在输入框右下角查找 MCP 工具图标
3. 尝试示例查询:
   • "在我 Azure Search 索引中搜索关于 AI 的信息"
   • "使用向量搜索工具查找向量数据库"
   • "使用混合搜索查找神经网络相关信息"

故障排除

• 服务器未出现: 检查 Claude Desktop 日志 (%APPDATA%\Claude\logs\mcp*.log)
• 连接问题: 验证配置中的路径和环境变量
• 服务器测试: 直接运行 python azure_search_server.py

自定义

• 修改 AzureSearchClient 类中的搜索方法
• 使用 @mcp.tool() 装饰器添加新功能
• 自定义搜索结果的格式化

许可

本项目采用 MIT 许可证