MCP服务器-Azure-AI搜索

Name: MCP服务器-Azure-AI搜索
Author: farzad528

作者：farzad52853 星标更新：2025-03-19

安装使用来源：spider==github.com

项目介绍

Azure AI 代理服务 + Azure AI 搜索 MCP 服务器

这是一个启用 Claude Desktop 使用 Azure AI 服务搜索内容的 Model Context Protocol (MCP) 服务器。可以选择 Azure AI 代理服务（包括文档搜索和网络搜索）或直接集成 Azure AI 搜索。

概述

本项目提供了两种 MCP 服务器实现，用于连接 Claude Desktop 和 Azure 搜索功能：

Azure AI 代理服务实现（推荐） - 使用强大的 Azure AI 代理服务提供：
- Azure AI 搜索工具 - 使用增强的人工智能结果搜索已索引的文档
- Bing 网络定位工具 - 带有来源引用的网络搜索
直接 Azure AI 搜索实现 - 直接连接到 Azure AI 搜索，具有三种方法：
- 关键词搜索 - 精确词法匹配
- 向量搜索 - 使用嵌入进行语义相似性搜索
- 混合搜索 - 关键词和向量搜索的组合

特性

增强的人工智能搜索 - Azure AI 代理服务通过智能处理优化搜索结果
多种数据源 - 搜索您的私有文档和公共网络
来源引用 - 网络搜索结果包含原始来源的引用
灵活的实现 - 选择 Azure AI 代理服务或直接 Azure AI 搜索集成
无缝的 Claude 集成 - 所有搜索功能均可通过 Claude Desktop 的界面访问
可定制 - 容易扩展或修改搜索行为

快速链接

要求

Python: 版本 3.10 或更高
Claude Desktop: 最新版本
Azure 资源：
- 包含向量化文本数据索引的 Azure AI 搜索服务
- 对于代理服务：带有 Azure AI 搜索和 Bing 连接的 Azure AI 项目
操作系统： Windows 或 macOS（提供 Windows 指令，但可适应其他系统）

Azure AI 代理服务实现（推荐）

设置指南

项目目录：

mkdir mcp-server-azure-ai-search
cd mcp-server-azure-ai-search

创建一个 .env 文件：

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

设置虚拟环境：

uv venv
.venv\Scripts\activate
uv pip install "mcp[cli]" azure-identity python-dotenv azure-ai-projects

使用 azure_ai_agent_service_server.py 脚本 进行与 Azure AI 代理服务的集成。

Azure AI 代理服务设置

在使用实现之前，您需要：

创建一个 Azure AI 项目：
- 转到 Azure 门户并创建一个新的 Azure AI 项目
- 记录项目连接字符串和模型部署名称
创建一个 Azure AI 搜索连接：
- 在您的 Azure AI 项目中，添加到您的 Azure AI 搜索服务的连接
- 记录连接名称和索引名称
创建一个 Bing 网络搜索连接：
- 在您的 Azure AI 项目中，添加到 Bing 搜索服务的连接
- 记录连接名称
使用 Azure 进行身份验证：
```
az login
```

配置 Claude Desktop

{
  "mcpServers": {
    "azure-ai-agent": {
      "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\azure_ai_agent_service_server.py"],
      "env": {
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        你的项目连接字符串",
        "MODEL_DEPLOYMENT_NAME": "your-model-deployment-name",
        你的模型部署名称",
        "AI_SEARCH_CONNECTION_NAME": "your-search-connection-name",
        你的搜索连接名称",
        "BING_CONNECTION_NAME": "your-bing-connection-name",
        你的Bing连接名称",
        "AI_SEARCH_INDEX_NAME": "your-index-name"
        你的索引名称"
      }
    }
  }
}

注意： 将路径占位符替换为您实际的项目路径。

直接 Azure AI 搜索实现

对于那些希望直接集成 Azure AI 搜索而不使用代理服务的人来说：

创建不同的 .env 文件：

echo "AZURE_SEARCH_SERVICE_ENDPOINT=https://your-service-name.search.windows.net" > .env
echo "AZURE_SEARCH_INDEX_NAME=your-index-name" >> .env
echo "AZURE_SEARCH_API_KEY=your-api-key" >> .env

安装依赖项：

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

使用 azure_search_server.py 脚本 进行与 Azure AI 搜索的直接集成。

配置 Claude Desktop：

{
  "mcpServers": {
    "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"
      }
    }
  }
}

测试服务器

重启 Claude Desktop 加载新的配置
查找 MCP 工具图标（锤子图标）位于输入字段右下角
尝试以下查询：
- "在我的 Azure 搜索索引中查找有关人工智能的信息"
- "搜索网络上关于 LLM 的最新发展"
- "使用混合搜索查找有关神经网络的信息"

故障排除

服务器未出现：
- 检查 Claude Desktop 日志（Windows 上位于 %APPDATA%\Claude\logs\mcp*.log）
- 核实配置中的文件路径和环境变量
- 测试直接运行服务器：python azure_ai_agent_service_server.py 或 uv run python azure_ai_agent_service_server.py
Azure AI 代理服务问题：
- 确保您的 Azure AI 项目正确配置
- 核实连接存在且配置正确
- 检查您的 Azure 身份验证状态

自定义您的服务器

修改工具指令： 调整提供给每个代理的指令以改变它们如何处理查询
添加新工具： 使用 @mcp.tool() 装饰器集成额外的工具
自定义响应格式： 编辑响应的格式和返回方式至 Claude Desktop
调整网络搜索参数： 修改网络搜索工具以专注于特定领域

许可证

本项目根据 MIT 许可证发布。