acuvity/mcp-server-microsoft-graph

mcp-server-microsoft-graph镜像说明

镜像概述

本镜像由Acuvity维护，是一款安全的MCP服务器镜像，用于连接Microsoft Graph API获取应用、站点、用户等数据。镜像基于Alpine 3.21构建，支持amd64和arm64架构，提供严格的安全防护和多种集成方式。

核心功能

1. Microsoft Graph集成：连接API获取应用、站点、用户等数据
2. 安全沙箱：
   • 隔离执行环境，防止横向移动
   • 默认非root用户运行，遵循最小权限原则
   • 只读文件系统，确保运行时不可篡改
   • 版本固定，保证部署一致性
   • CVE扫描和SBOM溯源，支持供应链安全
3. 运行时防护：
   • Minibridge集成，实现安全Agent-MCP连接和Rego策略 enforcement
   • 内置防护规则（如敏感数据检测、秘密信息脱敏、 schema合规等）

使用场景

• VS Code、Windsurf IDE、Cursor IDE等开发工具集成
• Claude Desktop客户端扩展
• OpenAI Python SDK调用
• 本地/远程部署MCP服务

配置说明

环境变量要求

需设置以下必填环境变量：

• MCP_SERVER_MICROSOFT_GRAPH_TENANT_ID：租户ID
• MCP_SERVER_MICROSOFT_GRAPH_CLIENT_ID：客户端ID
• MCP_SERVER_MICROSOFT_GRAPH_CLIENT_SECRET：客户端密钥

Docker部署示例

本地HTTP/SSE模式

bash
docker run -it -p 8000:8000 --rm --read-only \
  -e MCP_SERVER_MICROSOFT_GRAPH_TENANT_ID=your_tenant_id \
  -e MCP_SERVER_MICROSOFT_GRAPH_CLIENT_ID=your_client_id \
  -e MCP_SERVER_MICROSOFT_GRAPH_CLIENT_SECRET=your_client_secret \
  docker.io/acuvity/mcp-server-microsoft-graph:1.0.1

远程WebSocket模式（带MTLS）

1. 启动后端服务：

bash
docker run -it -p 8000:8000 --rm --read-only \
  -e MINIBRIDGE_MODE=backend \
  -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem \
  -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem \
  -e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pem \
  -v $PWD/certs:/certs \
  docker.io/acuvity/mcp-server-microsoft-graph:1.0.1

2. 本地Minibridge前端连接：

json
{
  "mcpServers": {
    "acuvity-mcp-server-microsoft-graph": {
      "command": "minibridge",
      "args": ["frontend", "--backend", "wss://<remote-url>:8000/ws", "--tls-client-backend-ca", "/path/to/ca.pem", "--tls-client-cert", "/path/to/client-cert.pem", "--tls-client-key", "/path/to/client-key.pem"]
    }
  }
}

Kubernetes部署（Helm）

bash
# 查看Chart信息
helm show readme oci://docker.io/acuvity/mcp-server-microsoft-graph --version 1.0.0
# 安装Chart
helm install mcp-server-microsoft-graph oci://docker.io/acuvity/mcp-server-microsoft-graph --version 1.0.0 \
  --set secrets.MCP_SERVER_MICROSOFT_GRAPH_TENANT_ID.value=your_tenant_id \
  --set secrets.MCP_SERVER_MICROSOFT_GRAPH_CLIENT_ID.value=your_client_id \
  --set secrets.MCP_SERVER_MICROSOFT_GRAPH_CLIENT_SECRET.value=your_client_secret

客户端集成

支持VS Code、Windsurf IDE、Cursor IDE、Claude Desktop及OpenAI Python SDK等集成，具体配置可参考官方文档。