bizflycloud-mcp-server

🚀 Bizfly 云 MCP 服务器

这是一个基于 mark3labs/mcp-go SDK 实现的模型上下文协议 (MCP) 服务器，其主要作用是连接到 Bizfly 云，进而实现对云资源的便捷管理。

🚀 快速开始

✨ 主要特性

• 借助 mark3labs/mcp-go SDK 搭建，能够与 Bizfly 云建立连接，高效管理云资源。
• 提供丰富的 MCP 工具，涵盖服务器管理和卷管理等多个方面。
• 具备标准输入输出传输、标准化响应格式、资源组织、类型安全和错误处理等 MCP 功能。

📦 安装指南

先决条件

• Go 1.21 或更高版本
• Bizfly 云账户凭证
• 安装了 Cursor 或 Claude Desktop

设置步骤

1. 克隆仓库。
2. 配置环境变量：

   export BIZFLY_USERNAME=你的用户名
   export BIZFLY_PASSWORD=你的密码
   export BIZFLY_REGION=河内  # 可选，默认为河内
   export BIZFLY_API_URL=https://manage.Bizfly Cloud.vn  # 可选，默认为 https://manage.Bizfly Cloud.vn
   

3. 安装依赖：

   go mod download
   

💻 使用示例

运行服务器

针对 Cursor/Claude Desktop 的集成

1. 构建服务器：

   go build -o bizfly-mcp-server
   

2. 配置您的 MCP 客户端（在 Cursor 或 Claude Desktop 中），通过添加以下内容到配置文件：
   • 对于 Cursor：

   {
       "mcpServers": {
           "bizfly": {
               "command": "/绝对路径/bizfly-mcp-server",
               "env": {
                   "BIZFLY_USERNAME": "你的用户名",
                   "BIZFLY_PASSWORD": "你的密码",
                   "BIZFLY_REGION": "河内"
               }
           }
       }
   }
   

   • 对于 Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)：

   {
       "mcpServers": {
           "bizfly": {
               "command": "/绝对路径/bizfly-mcp-server",
               "env": {
                   "BIZFLY_USERNAME": "你的用户名",
                   "BIZFLY_PASSWORD": "你的密码",
                   "BIZFLY_REGION": "河内"
               }
           }
       }
   }
   

可用工具

该服务器提供以下 MCP 工具：

服务器管理

• list_servers - 列出所有 Bizfly 云服务器
• start_server - 启动一个服务器
• reboot_server - 重启服务器
• delete_server - 删除服务器
• resize_server - 调整服务器规格
• list_flavors - 列出可用的服务器型号

卷管理

• list_volumes - 列出所有卷
• create_volume - 创建新卷
• delete_volume - 删除卷
• resize_volume - 调整卷大小
• list_volume_types - 列出可用的卷类型
• show_volume_type - 显示卷类型的详细信息

🔧 技术细节

MCP 功能

1. 标准输入输出传输：使用(stdin/stdout)实现与 Cursor/Claude Desktop 的无缝集成。
2. 标准化响应格式：所有响应均遵循 MCP 格式，包含上下文、类型、数据和根字段。
3. 资源组织：资源按根路径进行组织。
4. 类型安全：对所有资源进行强类型化处理。
5. 错误处理：采用标准的 MCP 格式输出错误信息。

📄 许可证

文档未提及许可证信息。

⚠️ 重要提示

请确保妥善保管您的凭证，绝不在版本控制系统中提交。