Azure AI Agent 服务 + Azure AI Search MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 Claude 桌面可以通过 Azure AI 服务搜索你的内容。选择使用 Azure AI Agent Service（同时支持文档搜索和网络搜索）或直接集成到 Azure AI Search。

概述

此项目提供了两种 MCP 服务器实现，用于将 Claude 桌面连接到 Azure 搜索功能：

1. Azure AI Agent Service 实现（推荐） - 使用强大的 Azure AI Agent Service 提供：

   • Azure AI 搜索工具 - 在你的索引文档中搜索并获得增强的上下文
   • 必应网络内容工具 - 从互联网获取实时信息

2. 直接集成到 Azure AI Search - 提供三种搜索模式：

   • 关键词搜索 - 精确匹配搜索内容
   • 向量相似度搜索 - 基于语义相似性进行搜索
   • 混合搜索 - 结合关键词和上下文理解的综合搜索

特性

• 支持多语言和复杂查询
• 提供实时网络搜索功能
• 可扩展的工具链设计
• 高性能文档检索引擎

快速链接

• Azure AI Agent Service 官方文档
• Azure AI Search 文档
• Claude 桌面 MCP 插件开发指南

配置要求

1. 推荐使用环境：

   • Windows 10 或更高版本
   • Python 3.8+

2. 必需依赖项：

   • Azure SDK for Python (azure-search-documents, azure-ai-agent)
   • Python 网络请求库 (requests)

安装与配置

使用 Azure AI Agent Service

1. 创建一个新的 .env 文件并添加以下内容：

AZURE_AI_AGENT_ENDPOINT=your-endpoint
AZURE_AI_AGENT_KEY=your-key
AZURE_SEARCH_SERVICE_ENDPOINT=your-search-service-endpoint
AZURE_SEARCH_API_KEY=your-search-api-key

2. 安装依赖项：

pip install "mcp[cli]" azure-ai-agent==1.0.0 python-dotenv

3. 启动服务器：

python azure_ai_agent_service_server.py

直接集成到 Azure AI Search

1. 创建一个新的 .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

2. 安装依赖项：

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

3. 启动服务器：

python azure_search_server.py

使用说明

1. 在 Claude 桌面中配置 MCP 服务器：

   {
     "mcpServers": {
       "azure-agent": {
         "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
         "args": ["C:\\path\\to\\azure_ai_agent_service_server.py"],
         "env": {
           "AZURE_AI_AGENT_ENDPOINT": "your-endpoint",
           "AZURE_AI_AGENT_KEY": "your-key"
         }
       },
       "azure-search": {
         "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
         "args": ["C:\\path\\to\\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"
         }
       }
     }
   }
   

2. 在 Claude 桌面重启后，点击输入框右侧的锤子图标即可使用 MCP 工具。

使用示例

- "搜索关于 Azure AI 的信息"
- "查找最新的大语言模型发展动态"
- "使用混合模式搜索神经网络相关资料"

故障排除

服务器未显示：

1. 检查 Claude 桌面日志（位于 %APPDATA%\Claude\logs\mcp*.log）
2. 确认文件路径和环境变量配置正确
3. 测试直接运行服务器：python azure_ai_agent_service_server.py

Azure AI Agent Service 问题：

1. 确保 Azure AI Project 配置正确
2. 检查连接是否已创建并配置完成
3. 验证 Azure 账号状态

自定义服务器

• 修改工具指令：调整每个代理的指令以更改其处理查询的方式
• 添加新工具：使用 @mcp.tool() 装饰器集成更多功能
• 自定义响应格式：编辑 Claude 桌面对响应的显示方式
• 调整网络搜索参数：优化必应搜索工具的搜索范围

许可证

此项目基于 MIT License 开源。