Bizfly Cloud MCP Server

A comprehensive Model Context Protocol (MCP) server implementation that connects to Bizfly Cloud to manage cloud resources. Built using the mark3labs/mcp-go SDK.

Features

• 🔧 Complete Cloud Management: Manage servers, volumes, load balancers, databases, Kubernetes clusters, and more
• 🔒 Secure Authentication: Uses environment variables for credentials
• 🐳 Docker Support: Ready-to-use Docker image for easy deployment
• 📦 10 Services Supported: Server, Volume, Load Balancer, Kubernetes, Database, DNS, CDN, KMS, Container Registry, AutoScaling, and Alert services
• ✅ Fully Tested: Comprehensive test suite with 196+ test cases
• 🚀 MCP Protocol: Compatible with Cursor and Claude Desktop
• 🌐 Multi-Region Support: Configurable region and API endpoints

Prerequisites

Local Development

• Go 1.23 or later
• Bizfly Cloud account credentials
• Cursor or Claude Desktop installed

Docker Deployment

• Docker 20.10 or later
• Docker Compose (optional)

Setup

Option 1: Docker (Recommended)

1. Clone the repository:

   git clone https://github.com/your-username/bizflycloud-mcp-server.git
   cd bizflycloud-mcp-server
   

2. Build the Docker image:

   docker build -t bizfly-mcp-server:latest .
   

3. Run the container:

   docker run -it --rm \
     -e BIZFLY_USERNAME=your_username \
     -e BIZFLY_PASSWORD=your_password \
     -e BIZFLY_REGION=HaNoi \
     bizfly-mcp-server:latest
   

4. Using Docker Compose:

   Create a .env file:

   BIZFLY_USERNAME=your_username
   BIZFLY_PASSWORD=your_password
   BIZFLY_REGION=HaNoi
   BIZFLY_API_URL=https://manage.bizflycloud.vn
   

   Run with docker-compose:

   docker-compose up
   

Option 2: Local Development

1. Clone the repository:

   git clone https://github.com/your-username/bizflycloud-mcp-server.git
   cd bizflycloud-mcp-server
   

2. Set up environment variables:

   export BIZFLY_USERNAME=your_username
   export BIZFLY_PASSWORD=your_password
   export BIZFLY_REGION=HaNoi  # Optional, defaults to HaNoi
   export BIZFLY_API_URL=https://manage.bizflycloud.vn  # Optional, defaults to https://manage.bizflycloud.vn
   

3. Install dependencies:

   go mod download
   

4. Build the server:

   go build -o bizfly-mcp-server
   

Running the Server

For Cursor/Claude Desktop Integration

1. Build the server:

   go build -o bizfly-mcp-server
   

2. Configure your MCP client (Cursor or Claude Desktop) by adding the following to the configuration:

For Cursor:

{
    "mcpServers": {
        "bizfly": {
            "command": "/absolute/path/to/bizfly-mcp-server",
            "env": {
                "BIZFLY_USERNAME": "your_username",
                "BIZFLY_PASSWORD": "your_password",
                "BIZFLY_REGION": "HaNoi"
            }
        }
    }
}

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
    "mcpServers": {
        "bizfly": {
            "command": "/absolute/path/to/bizfly-mcp-server",
            "env": {
                "BIZFLY_USERNAME": "your_username",
                "BIZFLY_PASSWORD": "your_password",
                "BIZFLY_REGION": "HaNoi"
            }
        }
    }
}

Available Tools

The server provides comprehensive MCP tools for managing all Bizfly Cloud services. All tool names are prefixed with bizflycloud_ for consistency.

🖥️ Server Management (bizflycloud_*)

• bizflycloud_list_servers - List all Bizfly Cloud servers
• bizflycloud_get_server - Get detailed information about a server
• bizflycloud_start_server - Start a stopped server
• bizflycloud_stop_server - Stop a running server
• bizflycloud_reboot_server - Soft reboot a server
• `bizflyclou

... View full README on GitHub