使用说明
项目简介
Azure MCP Hub 是一个中心仓库,旨在帮助开发者在 Azure 环境中快速搭建和使用 MCP 服务器。它汇集了多种语言的 MCP 服务器示例、客户端 SDK 以及与流行 AI 框架的集成方案,方便开发者构建能够与外部 API 交互的智能 агентов。
主要功能点
- 快速部署 MCP 服务器: 提供基于 Azure Functions 的 C#, Python 和 TypeScript 服务器示例,方便快速搭建和部署。
- 丰富的 SDK 支持: 链接到官方 MCP SDK,支持 C#, Python, TypeScript 和 Java 等多种语言,方便构建客户端、服务器和工具。
- 集成 AI 框架: 提供与 OpenAI Agents, Semantic Kernel, LangChain, Spring AI 等主流 AI 框架的集成指南,方便现有 AI 应用快速接入 MCP 能力。
- 即插即用服务器: 提供一系列预构建的 MCP 服务器,可以直接连接 Redis, PostgreSQL, Azure CLI, Kubernetes, GitHub 等常用数据和基础设施 API。
- 学习资源: 提供 MCP 协议规范文档链接,方便深入了解 MCP 技术。
安装步骤
本仓库本身作为一个资源中心,并不需要安装。要使用 MCP 服务器,你需要:
- 选择服务器实现: 根据你的需求,在 "1. Run Your Own MCP Server" 或 "3. Use Plug-and-Play MCP Servers" 部分选择合适的 MCP 服务器实现。例如,如果你想使用 Python 语言,可以选择 "Python" 示例。
- 部署服务器: 访问选定的服务器仓库,按照其 README 文件中的指引进行部署。通常会涉及到 Azure Functions 的部署流程。
- 配置客户端: 使用 MCP 客户端 SDK (例如 Python SDK) 构建你的 AI Agent,并配置连接到已部署的 MCP 服务器。
服务器配置
MCP 客户端需要配置服务器连接信息才能与 MCP 服务器通信。以下是一个典型的 JSON 配置示例,你需要根据你实际部署的服务器进行调整:
{ "serverName": "AzureFunctionMCP", "command": "https://<your-function-app-name>.azurewebsites.net/api/mcp", "args": [] }
- 'serverName': 为你的 MCP 服务器指定一个易于识别的名称,例如 "AzureFunctionMCP"。
- 'command': 关键配置。这是 MCP 服务器的访问地址。对于基于 Azure Functions 的服务器,通常是 Function App 的 API 端点。请替换 '<your-function-app-name>.azurewebsites.net' 为你实际部署的 Function App 地址。具体的路径 '/api/mcp' 需要参考你选择的服务器示例的文档。
- 'args': 可选参数,通常为空数组 '[]'。某些 MCP 服务器可能需要额外的启动参数,具体请参考服务器的文档。
注意: 'command' 的具体格式和协议 (例如 'http' 或 'https') 需要与你部署的 MCP 服务器类型保持一致。 上述示例假设服务器使用 HTTP 协议。
基本使用方法
- 构建 MCP 客户端: 使用官方 MCP SDK (例如 Python SDK) 在你的 AI Agent 代码中初始化 MCP 客户端。
- 配置服务器连接: 将上述 JSON 配置信息传递给 MCP 客户端,建立与 MCP 服务器的连接。
- 调用 MCP 功能: 通过 MCP 客户端,你可以调用 MCP 服务器提供的资源 (Resources)、工具 (Tools) 和 Prompt 模板 (Prompts),从而扩展 AI Agent 的能力,使其能够访问外部数据和执行外部操作。
- 参考示例: Azure MCP Hub 仓库及其链接的子仓库中包含丰富的示例代码,可以帮助你快速上手 MCP 服务器和客户端的开发。
信息
分类
开发者工具