Proxmox MCP 项目文档

安装指南

安装方式

1. 通过 PyPI 安装： 使用 pip 进行安装：

   pip install proxmox-mcp
   

2. 从源码安装： 克隆仓库并安装：

   git clone https://github.com/yourusername/proxmox-mcp.git
   cd proxmox-mcp
   python setup.py install
   

使用说明

配置文件

将 config.example.json 复制为 config.json 并根据需要修改配置。

启动 MCP 服务

在虚拟环境中启动 MCP：

python -m proxmox_mcp.server

功能概述

MCP 提供以下核心功能：

• VM 管理：创建、删除和管理虚拟机。
• 存储管理：配置和监控存储池。
• 网络管理：管理网络接口和防火墙规则。
• 集群状态：查看整个 Proxmox 集群的状态信息。

工具指南

获取帮助

使用 mcp --help 查看所有可用命令及其选项。

开发信息

运行测试

在虚拟环境中运行测试：

pytest tests/

格式代码

格式化项目代码：

black .

类型检查

进行静态类型检查：

mypy .

代码规范

检查代码风格：

ruff .

项目结构

proxmox-mcp/
├── src/
│   └── proxmox_mcp/
│       ├── server.py          # 主 MCP 服务实现
│       ├── config/            # 配置处理模块
│       ├── core/              # 核心功能模块
│       ├── formatting/        # 输出格式化和主题模块
│       ├── tools/             # 工具实现模块
│       │   └── console/       # VM 控制台操作子模块
│       └── utils/             # 辅助工具模块（认证、日志）
├── tests/                     # 测试套件目录
├── proxmox-config/
│   └── config.example.json    # 配置文件示例
├── pyproject.toml            # 项目元数据和依赖管理
└── LICENSE                   # MIT 许可证文件

许可证

MIT 许可证

许可条款：

版权 © [年份] [作者姓名]

准许免费使用、复制、修改及分发本软件，但需保留以上版权声明和本许可声明。

对于因使用或无法使用该软件而产生的任何损害或问题，作者不承担责任。

注意：此翻译为仅供参考，具体内容请以原始英文文档为准。