Bizflycloud MCP Server

🚀 Bizfly Cloud MCP Server

A Model Context Protocol (MCP) server implemented using the mark3labs/mcp-go SDK, designed to connect to Bizfly Cloud for managing cloud resources.

🚀 Quick Start

✨ Features

• Connect to Bizfly Cloud to manage cloud resources.
• Provide a series of MCP tools for server and volume management.
• Seamless integration with Cursor/Claude Desktop.

📦 Installation

Prerequisites

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

Setup

1. Clone the repository.
2. Configure environment variables:

   export BIZFLY_USERNAME=your_username
   export BIZFLY_PASSWORD=your_password
   export BIZFLY_REGION=Hanoi  # Optional, default is Hanoi
   export BIZFLY_API_URL=https://manage.Bizfly Cloud.vn  # Optional, default is https://manage.Bizfly Cloud.vn
   

3. Install dependencies:

   go mod download
   

💻 Usage Examples

Basic Usage

Run the Server

For integration with Cursor/Claude Desktop:

1. Build the server:

   go build -o bizfly-mcp-server
   

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

For Cursor:

{
    "mcpServers": {
        "bizfly": {
            "command": "/absolute_path/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/bizfly-mcp-server",
            "env": {
                "BIZFLY_USERNAME": "your_username",
                "BIZFLY_PASSWORD": "your_password",
                "BIZFLY_REGION": "Hanoi"
            }
        }
    }
}

Advanced Usage

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's specifications.
• 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_volume_types - List available volume types.
• show_volume_type - Show detailed information about a volume type.

🔧 Technical Details

MCP Features

1. Standard Input/Output Transmission: Achieve seamless integration with Cursor/Claude Desktop using (stdin/stdout).
2. Standardized Response Format: All responses follow the MCP format, including context, type, data, and root fields.
3. Resource Organization: Resources are organized by root paths.
4. Type Safety: All resources are strongly typed.
5. Error Handling: Output error messages in the standard MCP format.

⚠️ Important Note

Please ensure you keep your credentials secure and never commit them to the version control system.