
Azure AI Agent Service + Azure AI Search MCP Server

2025.03.24
0
PythonAI搜索文档搜索网页搜索搜索工具开发效率
Azure AI Agent Service + Azure AI Search MCP Server 是一个基于模型上下文协议(MCP)的服务,旨在为Claude Desktop提供与Azure AI服务的搜索能力集成。该服务提供两种实现方式:推荐使用Azure AI Agent Service实现,支持文档搜索和网页搜索;另一种是直接集成Azure AI Search,支持关键词搜索、向量搜索和混合搜索。该服务具备AI增强搜索、多数据源搜索、来源引用等功能,适用于需要高效搜索和整合信息的场景。
View on GitHub
Overview
基本能力
产品定位
该服务是一个连接Claude Desktop与Azure AI搜索能力的MCP服务器,旨在提供高效、智能的搜索解决方案。
核心功能
- AI增强搜索:通过Azure AI Agent Service优化搜索结果,提供智能处理。
- 多数据源搜索:支持搜索私有文档和公共网页。
- 来源引用:网页搜索结果包含原始来源的引用。
- 灵活的实现方式:可选择Azure AI Agent Service或直接集成Azure AI Search。
- 无缝集成Claude:所有搜索功能可通过Claude Desktop界面访问。
- 可定制性:易于扩展或修改搜索行为。
适用场景
- 需要高效搜索和整合私有文档的场景。
- 需要结合网页搜索和私有文档搜索的场景。
- 需要AI增强搜索结果以提高准确性的场景。
工具列表
- Azure AI Search Tool:搜索索引文档,提供AI增强结果。
- Bing Web Grounding Tool:搜索网页并提供来源引用。
- Keyword Search:直接集成Azure AI Search的关键词搜索。
- Vector Search:直接集成Azure AI Search的向量搜索。
- Hybrid Search:直接集成Azure AI Search的混合搜索。
常见问题解答
- 服务器未出现:检查Claude Desktop日志,验证文件路径和环境变量配置。
- Azure AI Agent Service问题:确保Azure AI项目配置正确,检查连接和认证状态。
使用教程
使用依赖
- Python:版本3.10或更高。
- Claude Desktop:最新版本。
- Azure资源:
- Azure AI Search服务,包含向量化文本数据的索引。
- 对于Agent Service:需要Azure AI项目,包含Azure AI Search和Bing连接。
安装教程
- 创建项目目录:
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"
- "Find information about neural networks using hybrid search"