🚀 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相关信息"
- 使用必应网络定位工具：
- "在网络上查找大语言模型的最新发展"
- 使用混合搜索工具：
- "查找关于深度学习的研究论文"
常见问题
服务器未显示
- 检查Claude Desktop日志（位于
%APPDATA%\Claude\logs\mcp*.log） - 确保文件路径和环境变量配置正确
- 测试直接运行服务器：
python server.py
Azure AI Agent Service问题
- 确保Azure AI项目正确配置
- 验证连接是否存在且配置正确
- 检查Azure认证状态
自定义选项
- 修改工具指令 - 调整每个代理的指令以改变其处理查询的方式
- 添加新功能 - 使用
@mcp.tool()装饰器集成更多功能 - 自定义响应格式 - 编辑Claude Desktop返回响应的方式
- 调整网络搜索参数 - 修改必应搜索工具的关注领域
📄 许可证
此项目使用MIT许可证。