
Azure AI Agent Service + Azure AI Search MCP Server

2025.03.19
35
Python搜索工具AI 增强搜索文档搜索网络搜索搜索工具开发效率
mcp-server-azure-ai-agents 是一个基于 Azure AI 服务的 MCP(Model Context Protocol)服务器,旨在为 Claude Desktop 提供强大的搜索功能。它支持两种实现方式:Azure AI Agent Service(推荐)和直接 Azure AI Search 集成。Azure AI Agent Service 提供 AI 增强的文档搜索和 Bing 网络搜索功能,而直接 Azure AI Search 集成则支持关键词搜索、向量搜索和混合搜索。该服务适用于需要高效搜索私有文档和公共网络内容的场景,特别是在 AI 和 LLM 相关的研究和开发中。
View on GitHub
Overview
基本能力
产品定位
mcp-server-azure-ai-agents 是一个连接 Claude Desktop 与 Azure AI 服务的 MCP 服务器,提供强大的搜索功能,包括私有文档搜索和公共网络搜索。
核心功能
- Azure AI Agent Service 实现(推荐)
- Azure AI 搜索工具:搜索索引文档,提供 AI 增强的结果
-
Bing 网络搜索工具:搜索网络内容,并提供来源引用
-
直接 Azure AI Search 实现
- 关键词搜索:精确的词法匹配
- 向量搜索:使用嵌入的语义相似性搜索
- 混合搜索:关键词和向量搜索的组合
适用场景
- 在 Claude Desktop 中快速搜索私有文档和公共网络内容
- AI 和 LLM 相关的研究和开发
- 需要高效搜索和引用来源的场景
工具列表
- Azure AI 搜索工具:搜索私有文档,提供 AI 增强的结果
- Bing 网络搜索工具:搜索网络内容,并提供来源引用
- 关键词搜索工具:精确的词法匹配搜索
- 向量搜索工具:语义相似性搜索
- 混合搜索工具:结合关键词和向量搜索
常见问题解答
- 服务器未出现:检查 Claude Desktop 日志,验证文件路径和环境变量
- Azure AI Agent Service 问题:确保 Azure AI 项目配置正确,验证连接和认证状态
使用教程
使用依赖
- Python:版本 3.10 或更高
- Claude Desktop:最新版本
- Azure 资源:
- Azure AI Search 服务
- Azure AI 项目(用于 Agent Service)
安装教程
-
创建项目目录
bash mkdir mcp-server-azure-ai-search cd mcp-server-azure-ai-search
-
创建 .env 文件
bash echo "PROJECT_CONNECTION_STRING=your-project-connection-string" > .env echo "MODEL_DEPLOYMENT_NAME=your-model-deployment-name" >> .env echo "AI_SEARCH_CONNECTION_NAME=your-search-connection-name" >> .env echo "BING_CONNECTION_NAME=your-bing-connection-name" >> .env echo "AI_SEARCH_INDEX_NAME=your-index-name" >> .env
-
设置虚拟环境
bash uv venv .venv\Scripts\activate uv pip install "mcp[cli]" azure-identity python-dotenv azure-ai-projects
调试方式
- 重启 Claude Desktop 以加载新配置
- 在输入框的右下角查找 MCP 工具图标(锤子图标)
- 尝试查询,例如:
- "Search for information about AI in my Azure Search index"
- "Search the web for the latest developments in LLMs"