MCP Server

🚀 Azure AI Agent 服务 + Azure AI Search MCP 服务器

本项目是一个模型上下文协议 (MCP) 服务器，借助 Azure AI 服务，让 Claude 桌面能够搜索你的内容。你可以选择使用 Azure AI Agent Service（支持文档搜索与网络搜索），也能直接集成到 Azure AI Search。

🚀 快速开始

此项目提供了两种 MCP 服务器实现，用于将 Claude 桌面连接到 Azure 搜索功能：

1. Azure AI Agent Service 实现（推荐） - 使用强大的 Azure AI Agent Service 提供：

   • Azure AI 搜索工具 - 在你的索引文档中搜索并获得增强的上下文
   • 必应网络内容工具 - 从互联网获取实时信息

2. 直接集成到 Azure AI Search - 提供三种搜索模式：

   • 关键词搜索 - 精确匹配搜索内容
   • 向量相似度搜索 - 基于语义相似性进行搜索
   • 混合搜索 - 结合关键词和上下文理解的综合搜索

✨ 主要特性

• 支持多语言和复杂查询
• 提供实时网络搜索功能
• 可扩展的工具链设计
• 高性能文档检索引擎

🔗 快速链接

• Azure AI Agent Service 官方文档
• Azure AI Search 文档
• Claude 桌面 MCP 插件开发指南

📦 安装指南

配置要求

1. 推荐使用环境：

   • Windows 10 或更高版本
   • Python 3.8+

2. 必需依赖项：

   • Azure SDK for Python (azure-search-documents, azure-ai-agent)
   • Python 网络请求库 (requests)

使用 Azure AI Agent Service

1. 创建一个新的 .env 文件并添加以下内容：

AZURE_AI_AGENT_ENDPOINT=your-endpoint
AZURE_AI_AGENT_KEY=your-key
AZURE_SEARCH_SERVICE_ENDPOINT=your-search-service-endpoint
AZURE_SEARCH_API_KEY=your-search-api-key

2. 安装依赖项：

pip install "mcp[cli]" azure-ai-agent==1.0.0 python-dotenv

3. 启动服务器：

python azure_ai_agent_service_server.py

直接集成到 Azure AI Search

1. 创建一个新的 .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

2. 安装依赖项：

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

3. 启动服务器：

python azure_search_server.py

💻 使用示例

基础用法

在 Claude 桌面中可输入以下查询示例：

- "搜索关于 Azure AI 的信息"
- "查找最新的大语言模型发展动态"
- "使用混合模式搜索神经网络相关资料"

📚 详细文档

使用说明

1. 在 Claude 桌面中配置 MCP 服务器：

   {
     "mcpServers": {
       "azure-agent": {
         "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
         "args": ["C:\\path\\to\\azure_ai_agent_service_server.py"],
         "env": {
           "AZURE_AI_AGENT_ENDPOINT": "your-endpoint",
           "AZURE_AI_AGENT_KEY": "your-key"
         }
       },
       "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"
         }
       }
     }
   }
   

2. 在 Claude 桌面重启后，点击输入框右侧的锤子图标即可使用 MCP 工具。

故障排除

服务器未显示：

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

Azure AI Agent Service 问题：

1. 确保 Azure AI Project 配置正确
2. 检查连接是否已创建并配置完成
3. 验证 Azure 账号状态

自定义服务器

• 修改工具指令：调整每个代理的指令以更改其处理查询的方式
• 添加新工具：使用 @mcp.tool() 装饰器集成更多功能
• 自定义响应格式：编辑 Claude 桌面对响应的显示方式
• 调整网络搜索参数：优化必应搜索工具的搜索范围

📄 许可证

此项目基于 MIT License 开源。