Back to MCP directory
publicPublicdnsLocal runtime

vcenter-mcp-server

vCenter-mcp-server是一款专为vCenter Server设计的MCP服务器工具,提供虚拟机管理、迁移和查询功能,简化虚拟化环境操作。

article

README

🚀 vCenter-mcp-server

vCenter-mcp-server 是一款专为 vCenter Server 量身打造的 MCP(模型上下文协议)服务器工具,其核心价值在于极大地简化了虚拟机管理任务。借助与 vCenter Server 的无缝集成,该工具为用户提供了一个高效且便捷的操作接口,可轻松执行虚拟机迁移、查询等常见操作。

🚀 快速开始

克隆代码

从 Gitee 仓库克隆项目代码:

git@gitee.com:rooky-top/vcenter-mcp-server.git

安装依赖

使用 pip 安装项目所需的依赖:

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

修改配置文件

修改 .env 文件,填写 vCenter Server 的连接信息:

VCENTER_HOST=192.168.103.66
VCENTER_USER=administrator@vsphere.local
VCENTER_PASSWORD=Password

配置说明 | 配置项 | 说明 | 必填 | | ---- | ---- | ---- | | VCENTER_HOST | vCenter 服务器地址 | 是 | | VCENTER_USER | 登录用户名 | 是 | | VCENTER_PASSWORD | 登录密码 | 是 |

运行服务器

启动服务前,请确保已安装所有依赖项,并配置好环境变量:

python server.py

✨ 主要特性

  • vCenter Server 连接:支持与 vCenter Server 的稳定连接,确保对虚拟化环境的全面访问。
  • 虚拟机迁移:允许用户将虚拟机从一台宿主机迁移到另一台宿主机,支持单个虚拟机、多个虚拟机以及整个宿主机的批量迁移。
  • 虚拟机信息查询:提供宿主机上虚拟机的详细信息查询功能,帮助用户快速了解虚拟机状态。

💻 使用示例

基础用法

创建虚拟机

  • 请求方式:POST
  • 请求路径:/api/vm/create
  • 请求体示例:
{
  "name": "test_vm",
  "cpu": 2,
  "memory": 4096,
  "disk_size": 50,
  "image_id": "ubuntu_2004"
}

迁移虚拟机

  • 请求方式:POST
  • 请求路径:/api/vm/migrate
  • 请求体示例:
{
  "vm_id": "123",
  "source_host": "host1",
  "target_host": "host2"
}

列出虚拟机信息

  • 请求方式:GET
  • 请求路径:/api/vm/list
  • 响应示例:
[
  {
    "id": 1,
    "name": "test_vm",
    "status": "running",
    "host": "host1"
  },
  {
    "id": 2,
    "name": "another_vm",
    "status": "stopped",
    "host": "host2"
  }
]

📚 详细文档

主要功能

  • 创建虚拟机:支持用户根据配置创建新的虚拟机。
  • 迁移虚拟机:支持多种迁移场景,满足不同用户需求。
  • 列出虚拟机信息:清晰展示宿主机上各虚拟机的关键信息。

更多功能持续更新中。

🤝 参与贡献

  • 欢迎 fork 本项目并提交 pull request。
  • 如果您有任何问题或建议,请在 issues 中提出。

⭐ 其他信息

  1. 使用 Readme_XXX.md 来支持不同的语言,例如 Readme_en.md, Readme_zh.md
  2. Gitee 官方博客 blog.gitee.com
  3. 您可以 https://gitee.com/explore 这个地址来了解 Gitee 上的优秀开源项目
  4. GVP 全称是 Gitee 最有价值开源项目,是综合评定出的优秀开源项目
  5. Gitee 官方提供的使用手册 https://gitee.com/help
  6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 https://gitee.com/gitee-stars/
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client