Azure AI Agent Service + Azure AI Search MCP Server

Azure AI Agent Service + Azure AI Search MCP Server

site icon
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 服务器,提供强大的搜索功能,包括私有文档搜索和公共网络搜索。

核心功能

  1. Azure AI Agent Service 实现(推荐)
  2. Azure AI 搜索工具:搜索索引文档,提供 AI 增强的结果
  3. Bing 网络搜索工具:搜索网络内容,并提供来源引用

  4. 直接 Azure AI Search 实现

  5. 关键词搜索:精确的词法匹配
  6. 向量搜索:使用嵌入的语义相似性搜索
  7. 混合搜索:关键词和向量搜索的组合

适用场景

  • 在 Claude Desktop 中快速搜索私有文档和公共网络内容
  • AI 和 LLM 相关的研究和开发
  • 需要高效搜索和引用来源的场景

工具列表

  1. Azure AI 搜索工具:搜索私有文档,提供 AI 增强的结果
  2. Bing 网络搜索工具:搜索网络内容,并提供来源引用
  3. 关键词搜索工具:精确的词法匹配搜索
  4. 向量搜索工具:语义相似性搜索
  5. 混合搜索工具:结合关键词和向量搜索

常见问题解答

  • 服务器未出现:检查 Claude Desktop 日志,验证文件路径和环境变量
  • Azure AI Agent Service 问题:确保 Azure AI 项目配置正确,验证连接和认证状态

使用教程

使用依赖

  1. Python:版本 3.10 或更高
  2. Claude Desktop:最新版本
  3. Azure 资源
  4. Azure AI Search 服务
  5. Azure AI 项目(用于 Agent Service)

安装教程

  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"

许可证

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