金大哥 - mcp_server MCP 详情

article

README

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

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

🚀 快速开始

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

Azure AI Agent Service 实现（推荐） - 使用强大的 Azure AI Agent Service 提供：
- Azure AI 搜索工具 - 在你的索引文档中搜索并获得增强的上下文
- 必应网络内容工具 - 从互联网获取实时信息
直接集成到 Azure AI Search - 提供三种搜索模式：
- 关键词搜索 - 精确匹配搜索内容
- 向量相似度搜索 - 基于语义相似性进行搜索
- 混合搜索 - 结合关键词和上下文理解的综合搜索

✨ 主要特性

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

📚 详细文档

快速链接

配置要求

推荐使用环境：
- Windows 10 或更高版本
- Python 3.8+
必需依赖项：
- Azure SDK for Python (azure-search-documents, azure-ai-agent)
- Python 网络请求库 (requests)

安装与配置

使用 Azure AI Agent Service

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

安装依赖项：

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

启动服务器：

python azure_ai_agent_service_server.py

直接集成到 Azure AI Search

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

安装依赖项：

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

启动服务器：

python azure_search_server.py

使用说明

在 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"
            }
        }
    }
}

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

使用示例

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

故障排除

服务器未显示：

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

Azure AI Agent Service 问题：

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

自定义服务器

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

📄 许可证

此项目基于 MIT License 开源。

mcp_server