farzad528_mcp-server-azure-ai-agents

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

本项目是一个模型上下文协议（MCP）服务器，能让Claude Desktop借助Azure AI服务开展内容搜索。你可以选择使用Azure AI Agent Service（涵盖文档搜索与网络搜索），也能直接集成Azure AI搜索。

🚀 快速开始

此项目提供了两种MCP服务器实现，用于将Claude Desktop与Azure搜索功能连接。你可以按照以下步骤完成安装和配置，开启搜索之旅。

✨ 主要特性

• 🌐 支持多种搜索模式：基于索引、网络和混合
• ⚙️ 可配置的工具指令以调整搜索行为
• 🎨 灵活的响应格式化选项
• 🚀 扩展性强，可轻松添加新功能
• 🌏 中文与英文双语支持

📦 安装指南

1. 安装Python环境

确保已安装Python 3.8或更高版本，并安装pip。

python --version
pip install --upgrade pip

2. 安装依赖项

对于Azure AI Agent Service：

uv pip install "mcp[cli]" azure-core==1.5.0 python-dotenv

对于直接Azure AI搜索：

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

3. 下载项目代码

从GitHub克隆仓库：

git clone https://github.com/your-organization/azure-ai-mcp.git
cd azure-ai-mcp

📚 详细文档

配置说明

Azure AI Agent Service配置

创建一个env_agent_service文件，添加以下内容并替换为您的实际信息：

AZURE_AI_SUBSCRIPTION_ID=your-subscription-id
AZURE_AI_ENDPOINT=https://your-region.api.cognitive.microsoft.com

直接Azure AI搜索配置

创建一个env_search_service文件，添加以下内容并替换为您的实际信息：

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

使用方法

启动服务器

对于Azure AI Agent Service：

uv run python server.py

对于直接Azure AI搜索：

uv run python search_server.py

在Claude Desktop中配置

将以下内容添加到Claude的配置文件中：

Azure AI Agent Service配置：

{
  "mcpServers": {
    "azure-agent-service": {
      "command": "C:\\路径\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\路径\\to\\server.py"],
      "env": {
        "AZURE_AI_SUBSCRIPTION_ID": "your-subscription-id",
        "AZURE_AI_ENDPOINT": "https://your-region.api.cognitive.microsoft.com"
      }
    }
  }
}

直接Azure AI搜索配置：

{
  "mcpServers": {
    "azure-search-service": {
      "command": "C:\\路径\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\路径\\to\\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中输入以下查询：

• 使用Azure AI搜索工具：
  • "搜索我的Azure索引中的AI相关信息"
• 使用必应网络定位工具：
  • "在网络上查找大语言模型的最新发展"
• 使用混合搜索工具：
  • "查找关于深度学习的研究论文"

常见问题

服务器未显示

1. 检查Claude Desktop日志（位于%APPDATA%\Claude\logs\mcp*.log）
2. 确保文件路径和环境变量配置正确
3. 测试直接运行服务器：python server.py

Azure AI Agent Service问题

1. 确保Azure AI项目正确配置
2. 验证连接是否存在且配置正确
3. 检查Azure认证状态

自定义选项

• 修改工具指令 - 调整每个代理的指令以改变其处理查询的方式
• 添加新功能 - 使用@mcp.tool()装饰器集成更多功能
• 自定义响应格式 - 编辑Claude Desktop返回响应的方式
• 调整网络搜索参数 - 修改必应搜索工具的关注领域

📄 许可证

此项目使用MIT许可证。