MCP Cloud Pc

一个基于微软Graph API的Azure云电脑管理服务器，提供用户列表查询、云电脑管理（重启、重命名、故障排查等）功能

云平台虚拟化 #云电脑 #Azure管理 #Graph API .Python

评分 : 2分

下载量 : 7.0K

更新时间 : 2025-04-28

打开站点

什么是Cloud PC Management MCP Server？

Cloud PC Management MCP Server是一个基于Microsoft Graph API的工具，旨在简化Azure Cloud PC的管理和操作。它提供了多种功能，如列出用户、重启Cloud PC、重命名Cloud PC以及故障排查等。

如何使用Cloud PC Management MCP Server？

只需按照简单的步骤配置并运行该服务器，即可开始管理您的Azure Cloud PCs。您可以通过命令行调用不同的API接口来执行具体任务。

适用场景

适合需要高效管理大量Azure Cloud PCs的企业IT管理员，尤其在远程办公环境中。

主要功能

列出所有注册用户

显示当前租户下所有已注册的用户信息。

列出所有Cloud PCs

获取当前租户下所有可用的Cloud PCs列表。

重启指定ID的Cloud PC

通过指定Cloud PC ID来重启设备。

重命名Cloud PC

更改特定Cloud PC的显示名称。

故障排查

对指定ID的Cloud PC进行故障排查。

结束试用期

终止指定Cloud PC的试用期。

获取审核状态

查看指定Cloud PC的审核状态。

重新部署Cloud PC

重新配置指定Cloud PC的操作系统和用户类型。

优势

支持多种高级管理功能，如故障排查和重新部署。

易于集成到现有工作流中，无需额外学习复杂的技术。

提高工作效率，减少手动操作时间。

局限性

依赖于Microsoft Graph API，可能受到网络限制影响。

需要提前配置环境变量（如客户端ID、秘密密钥等）。

某些高级功能可能需要订阅特定的Azure服务。

如何使用

安装和配置

确保已安装Python环境，并设置必要的环境变量（如MSGRAPH_TENANT_ID、MSGRAPH_CLIENT_ID、MSGRAPH_CLIENT_SECRET）。

启动服务器

运行MCP服务器脚本以激活管理功能。

执行管理任务

通过命令行调用相应API接口完成具体操作。

使用案例

列出所有Cloud PCs

展示当前租户下所有可用的Cloud PCs。

重启特定Cloud PC

针对特定ID的Cloud PC执行重启操作。

常见问题

如何获取MSGraph相关的环境变量？

为什么无法连接到Microsoft Graph API？

🚀 云电脑管理 MCP 服务器

MCP 服务器可借助 Microsoft Graph API 对 Azure 云电脑进行管理，为云电脑的管理工作提供了便利。

🚀 快速开始

与 Claude Desktop 配合使用

若要将此服务器与 Claude Desktop 结合使用，需在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "mcp-cloud-pc": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-cloud-pc",
        "mcp-cloud-pc.py"
      ],
      "env": {
        "MSGRAPH_TENANT_ID": "<YOUR GRAPH API TENANT ID>",
        "MSGRAPH_CLIENT_ID": "<YOUR GRAPH API CLIENT ID>",
        "MSGRAPH_CLIENT_SECRET": "<YOUR GRAPH API CLIENT SECRET>"
      }
    }
  }
}

✨ 主要特性

当前 MCP 服务器使用 'curl' 发送图数据库查询语言接口请求，这是由于 Python msgraph-sdk 文档与当前 SDK 实现不匹配。

💻 使用示例

工具列表

工具名称	功能描述	参数	返回值
`cloud_pc_list_users`	列出所有注册用户	无	用户信息列表的 JSON 格式字符串
`cloud_pc_list`	列出当前租户的所有可用云电脑	无	云电脑列表的 JSON 格式字符串
`cloud_pc_reboot`	重启指定 ID 的云电脑	云电脑 ID	无
`cloud_pc_rename`	设置指定 ID 云电脑的新显示名称	云电脑 ID、新的云电脑显示名称	无
`cloud_pc_troubleshoot`	调试指定 ID 的云电脑	云电脑 ID	无
`cloud_pc_end_grace_period`	结束指定 ID 云电脑的宽恕期	云电脑 ID	无
`cloud_pc_get_review_status`	获取特定 ID 云电脑的审查状态	云电脑 ID	无
`cloud_pc_reprovision`	使用 Windows 10 或 11 操作系统重新配置指定 ID 的云电脑，设置已 redeployed 用户类型	云电脑 ID、Windows 用户账户类型（可用类型：standardUser, administrator）、Windows 操作系统版本（可用版本：windows10, windows11）	无