Azure AI Agent Service + Azure AI Search MCP Server

Azure AI Agent Service + Azure AI Search MCP Server

site icon
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增强搜索结果以提高准确性的场景。

工具列表

  1. Azure AI Search Tool:搜索索引文档,提供AI增强结果。
  2. Bing Web Grounding Tool:搜索网页并提供来源引用。
  3. Keyword Search:直接集成Azure AI Search的关键词搜索。
  4. Vector Search:直接集成Azure AI Search的向量搜索。
  5. 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连接。

安装教程

  1. 创建项目目录bash mkdir mcp-server-azure-ai-search cd mcp-server-azure-ai-search
  2. 创建.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
  3. 设置虚拟环境bash uv venv .venv\Scripts\activate uv pip install "mcp[cli]" azure-identity python-dotenv azure-ai-projects

调试方式

  1. 重启Claude Desktop以加载新配置。
  2. 在输入框的右下角查找MCP工具图标(锤子图标)。
  3. 尝试查询,例如:
  4. "Search for information about AI in my Azure Search index"
  5. "Search the web for the latest developments in LLMs"
  6. "Find information about neural networks using hybrid search"

许可证

该项目遵循 Other 开源许可条款,请参阅 Other 了解完整条款。