feat: sandbox tools (#15)

* feat: add sandbox MCP tools

* feat: add sandbox disk and network tools

Author: BhautikChudasama

README.md

@@ -151,6 +151,7 @@ port: 8080
 base_url: https://your-domain.com
 authorization_server_url: https://your-auth-server.com
 api_base_url: https://api.createos.nodeops.network
+sandbox_api_base_url: https://your-fc-control-api.example.com
 transport: http       # "http" or "stdio"
 log_level: debug
 
@@ -220,6 +221,9 @@ The server exposes **85+ tools** organized into the following categories:
 | **GitHub** | `InstallGithubApp`, `ListConnectedGithubAccounts`, `ListGithubRepositories`, `ListGithubRepositoryBranches`, `GetGithubRepositoryContent` | GitHub integration for repo-based deployments |
 | **Account** | `GetCurrentUser`, `GetQuotas`, `GetSupportedProjectTypes` | User info, quotas, and platform capabilities |
 | **Transfers** | `TransferProject`, `GetProjectTransferUri`, `ListProjectTransferHistory` | Transfer project ownership between accounts |
+| **Sandboxes** | `CreateSandbox`, `UpdateSandbox`, `ExecSandbox`, `DeleteSandbox` | Create, update, execute commands in, and destroy sandbox VMs |
+| **Sandbox Disks** | `CreateDisk`, `ListDisks`, `GetDisk`, `DeleteDisk`, `AttachSandboxDisk`, `DetachSandboxDisk`, `ListSandboxDisks` | Register S3 disks and attach them to sandboxes |
+| **Sandbox Networks** | `CreateNetwork`, `ListNetworks`, `GetNetwork`, `DeleteNetwork`, `AttachSandboxNetwork`, `DetachSandboxNetwork` | Create private sandbox networks and manage membership |
 
 ---
 

config-files/config.yaml

@@ -2,6 +2,7 @@ port: 8080
 base_url:
 authorization_server_url:
 api_base_url:
+sandbox_api_base_url:
 transport: http
 log_level: debug
 

config/config.go

@@ -12,6 +12,7 @@ type Config struct {
 	BaseURL                string `yaml:"base_url"`
 	AuthorizationServerUrl string `yaml:"authorization_server_url"`
 	APIBaseUrl             string `yaml:"api_base_url"`
+	SandboxAPIBaseUrl      string `yaml:"sandbox_api_base_url"`
 	Transport              string `yaml:"transport"`
 	LogLevel               string `yaml:"log_level"`
 

handlers/AttachSandboxDisk.go

@@ -0,0 +1,28 @@
+package handler
+
+import (
+	"context"
+	"fmt"
+
+	mcputils "github.com/NodeOps-app/createos-mcp/helpers"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type AttachSandboxDiskParams struct {
+	ID   string                 `json:"id"`
+	Body map[string]interface{} `json:"body"`
+}
+
+func AttachSandboxDiskHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	authInfo, args, err := handleRequest(ctx, request)
+	if err != nil {
+		return nil, err
+	}
+
+	params, err := mcputils.ParamsParser[AttachSandboxDiskParams](args)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse parameters: %w", err)
+	}
+
+	return makeSandboxPostRequest(fmt.Sprintf("/v1/sandboxes/%s/disks", params.ID), params.Body, authInfo)
+}

handlers/AttachSandboxNetwork.go

@@ -0,0 +1,28 @@
+package handler
+
+import (
+	"context"
+	"fmt"
+
+	mcputils "github.com/NodeOps-app/createos-mcp/helpers"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type AttachSandboxNetworkParams struct {
+	ID   string                 `json:"id"`
+	Body map[string]interface{} `json:"body"`
+}
+
+func AttachSandboxNetworkHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	authInfo, args, err := handleRequest(ctx, request)
+	if err != nil {
+		return nil, err
+	}
+
+	params, err := mcputils.ParamsParser[AttachSandboxNetworkParams](args)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse parameters: %w", err)
+	}
+
+	return makeSandboxPostRequest(fmt.Sprintf("/v1/sandboxes/%s/networks", params.ID), params.Body, authInfo)
+}

handlers/CreateDisk.go

@@ -0,0 +1,27 @@
+package handler
+
+import (
+	"context"
+	"fmt"
+
+	mcputils "github.com/NodeOps-app/createos-mcp/helpers"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type CreateDiskParams struct {
+	Body map[string]interface{} `json:"body"`
+}
+
+func CreateDiskHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	authInfo, args, err := handleRequest(ctx, request)
+	if err != nil {
+		return nil, err
+	}
+
+	params, err := mcputils.ParamsParser[CreateDiskParams](args)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse parameters: %w", err)
+	}
+
+	return makeSandboxPostRequest("/v1/disks", params.Body, authInfo)
+}

handlers/CreateNetwork.go

@@ -0,0 +1,27 @@
+package handler
+
+import (
+	"context"
+	"fmt"
+
+	mcputils "github.com/NodeOps-app/createos-mcp/helpers"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type CreateNetworkParams struct {
+	Body map[string]interface{} `json:"body"`
+}
+
+func CreateNetworkHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	authInfo, args, err := handleRequest(ctx, request)
+	if err != nil {
+		return nil, err
+	}
+
+	params, err := mcputils.ParamsParser[CreateNetworkParams](args)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse parameters: %w", err)
+	}
+
+	return makeSandboxPostRequest("/v1/networks", params.Body, authInfo)
+}

handlers/CreateSandbox.go

@@ -0,0 +1,27 @@
+package handler
+
+import (
+	"context"
+	"fmt"
+
+	mcputils "github.com/NodeOps-app/createos-mcp/helpers"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type CreateSandboxParams struct {
+	Body map[string]interface{} `json:"body"`
+}
+
+func CreateSandboxHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	authInfo, args, err := handleRequest(ctx, request)
+	if err != nil {
+		return nil, err
+	}
+
+	params, err := mcputils.ParamsParser[CreateSandboxParams](args)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse parameters: %w", err)
+	}
+
+	return makeSandboxPostRequest("/v1/sandboxes", params.Body, authInfo)
+}

handlers/DeleteDisk.go

@@ -0,0 +1,27 @@
+package handler
+
+import (
+	"context"
+	"fmt"
+
+	mcputils "github.com/NodeOps-app/createos-mcp/helpers"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type DeleteDiskParams struct {
+	IDOrName string `json:"id_or_name"`
+}
+
+func DeleteDiskHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	authInfo, args, err := handleRequest(ctx, request)
+	if err != nil {
+		return nil, err
+	}
+
+	params, err := mcputils.ParamsParser[DeleteDiskParams](args)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse parameters: %w", err)
+	}
+
+	return makeSandboxDeleteRequest(fmt.Sprintf("/v1/disks/%s", params.IDOrName), authInfo)
+}

handlers/DeleteNetwork.go

@@ -0,0 +1,27 @@
+package handler
+
+import (
+	"context"
+	"fmt"
+
+	mcputils "github.com/NodeOps-app/createos-mcp/helpers"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type DeleteNetworkParams struct {
+	ID string `json:"id"`
+}
+
+func DeleteNetworkHandler(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	authInfo, args, err := handleRequest(ctx, request)
+	if err != nil {
+		return nil, err
+	}
+
+	params, err := mcputils.ParamsParser[DeleteNetworkParams](args)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse parameters: %w", err)
+	}
+
+	return makeSandboxDeleteRequest(fmt.Sprintf("/v1/networks/%s", params.ID), authInfo)
+}