What is Bizflycloud Mcp Server

bizflycloud-mcp-server is a Model Context Protocol (MCP) server implementation designed to connect with Bizfly Cloud for managing cloud resources. It is built using the mark3labs/mcp-go SDK.

Use cases

Use cases include managing cloud server instances, automating server operations, and integrating cloud resource management into applications.

How to use

To use bizflycloud-mcp-server, clone the repository, set up your environment variables with your Bizfly Cloud credentials, install the necessary dependencies, and build the server. Configure your MCP client (Cursor or Claude Desktop) to integrate with the server.

Key features

Key features include server management tools such as listing servers, starting, rebooting, deleting, and resizing servers on Bizfly Cloud.

Where to use

bizflycloud-mcp-server can be used in cloud computing environments, particularly for businesses and developers who utilize Bizfly Cloud services.

Bizfly Cloud MCP Server

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

Prerequisites

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

Setup

1. Clone the repository
2. Set up your 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.Bizfly Cloud.vn  # Optional, defaults to https://manage.Bizfly Cloud.vn
   

3. Install dependencies:

   go mod download
   

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 the following MCP tools:

Server Management

• list_servers - List all Bizfly Cloud servers
• start_server - Start a server
• reboot_server - Reboot a server
• delete_server - Delete a server
• resize_server - Resize a server
• list_flavors - List available server flavors

Volume Management

• list_volumes - List all volumes
• create_volume - Create a new volume
• delete_volume - Delete a volume
• resize_volume - Resize a volume
• list_snapshots - List all volume snapshots
• create_snapshot - Create a volume snapshot
• delete_snapshot - Delete a volume snapshot

Load Balancer Management

• list_loadbalancers - List all load balancers
• create_loadbalancer - Create a new load balancer
• delete_loadbalancer - Delete a load balancer

Kubernetes Management

• list_kubernetes_clusters - List all Kubernetes clusters
• create_kubernetes_cluster - Create a new Kubernetes cluster
• delete_kubernetes_cluster - Delete a Kubernetes cluster
• list_kubernetes_nodes - List nodes in a cluster

Database Management

• list_databases - List all databases
• list_datastores - List available database engines and versions
• create_database - Create a new database
• delete_database - Delete a database

Example Usage

You can interact with the server through natural language queries in Cursor or Claude Desktop:

• “Show me all my Bizfly Cloud servers”
• “List all volumes in my Bizfly Cloud account”
• “Create a new load balancer”
• “List available Kubernetes clusters”
• “Show me all databases”

MCP Implementation Details

This server uses the mark3labs/mcp-go SDK to implement the Model Context Protocol:

1. Standard I/O Transport: Uses stdin/stdout for communication with MCP clients
2. Tool Definitions: Clear tool descriptions and parameters
3. Error Handling: Proper error reporting in MCP format
4. Text Formatting: Human-readable output for resource listings

Authentication

The server uses your Bizfly Cloud username and password for authentication through environment variables:

• BIZFLY_USERNAME: Your Bizfly Cloud username (required)
• BIZFLY_PASSWORD: Your Bizfly Cloud password (required)
• BIZFLY_REGION: Region name (optional, defaults to “HaNoi”)
• BIZFLY_API_URL: API URL (optional, defaults to “https://manage.Bizfly Cloud.vn”)

Make sure to keep your credentials secure and never commit them to version control.

MCP Features

1. Standard I/O Transport: Uses stdin/stdout for seamless integration with Cursor/Claude Desktop
2. Standardized Response Format: All responses follow the MCP format with context, type, data, and root fields
3. Resource Organization: Resources are organized under root paths
4. Type Safety: Strong typing for all resources
5. Error Handling: Standardized error responses in MCP format