使用说明

项目简介

Blue Bridge 是一个基于 Model Context Protocol (MCP) 的服务器，它允许 LLM 客户端（如 MCP host）通过标准化的接口安全地访问和管理 Azure 资源。它作为 LLM 与 Azure 云环境之间的桥梁，能够连接到 Azure Managed Grafana、Azure Data Explorer (Kusto)、Azure Resource Graph 和 Azure Resource Manager 等服务。认证通过已登录的 Azure CLI 账号或托管身份进行，无需存储敏感密钥。

主要功能点

Azure 资源查询与管理: 提供访问 Azure Resource Graph 和 Azure Resource Manager 的能力，用于查询资源信息和执行管理操作。
Azure 数据探索: 支持连接到 Azure Data Explorer (Kusto) 集群，执行数据查询。
Azure 监控数据访问: 允许连接到 Azure Managed Grafana 端点，获取监控和可视化数据。
LLM 集成接口: 通过标准的 MCP 协议向 LLM 客户端暴露上述功能，使 LLM 能够理解和利用 Azure 上下文。
安全认证: 利用 Azure CLI 认证或托管身份 (Managed Identity) 实现无需在服务器中存储密钥的零密钥安全认证。
容器化部署: 提供 Docker 镜像，简化部署流程。

安装步骤

Blue Bridge 通常以 Docker 容器形式运行。

确保您的系统已安装 Docker。
根据需要访问的 Azure 服务，设置相应的环境变量（可选）。例如，如果您需要连接 Kusto，需要 '-e KustoUri=https://<my-kusto>.westus2.kusto.windows.net'。完整的环境变量列表请参考项目仓库的 README。

运行以下 Docker 命令启动服务器：

docker run --name bluebridge -p 6688:6688 \
  [可选环境变量，如 -e KustoUri=...] \
  bluebridge.azurecr.io/bluebridge:latest

这会将容器的 6688 端口映射到主机的 6688 端口。

首次运行时，容器会输出一个设备代码认证提示。按照提示在浏览器中完成 Azure 账号认证。
认证完成后，服务器将在 'http://localhost:6688' 监听连接。

服务器配置 (供 MCP 客户端使用)

要让您的 MCP 客户端 (MCP host) 连接并使用 Blue Bridge 服务器，您需要在客户端的 MCP 服务器配置中添加相应条目。这些配置通常以 JSON 格式呈现，包含以下关键信息：

'server name': 为此 MCP 服务器连接设置一个易于识别的名称，例如 '"blue-bridge"'。
'url': 指定 Blue Bridge 服务器的访问地址，例如 '"http://localhost:6688/sse"'。最后的 '/sse' 指示使用 Server-Sent Events 传输协议。
'transportType': 指明客户端应使用的传输协议类型，通常是 '"sse"'。
'timeout': 设置客户端等待服务器响应的超时时间，单位为秒，例如 '60'。
'disabled': 一个布尔值 ('true'/'false')，用于启用或禁用此服务器连接。
'autoApprove': 一个字符串数组，列出允许客户端自动执行、无需用户手动确认的请求类型。

根据您的 MCP 客户端的具体配置方式，将上述信息填入对应的字段即可建立连接。

基本使用方法

配置并连接成功后，您可以通过支持 MCP 协议的 LLM 客户端与 Blue Bridge 进行交互。当您向 LLM 提出与 Azure 资源相关的问题或请求时，如果客户端判定需要 Azure 上下文，它会通过 MCP 协议向 Blue Bridge 发送请求。Blue Bridge 执行相应的 Azure 操作并将结果返回给客户端，供 LLM 使用或展示。您可以参考项目仓库中提供的 'manual-for-ai.md' 文件获取示例交互方式。

关键词