Rackspace Spot MCP Server

A Model Context Protocol (MCP) server for Rackspace Spot - a managed Kubernetes platform with auction-based pricing.

Features

This MCP server provides tools for managing your Rackspace Spot infrastructure:

• Regions & Server Classes: List available regions and machine types
• Organizations: List organizations and their namespaces
• Cloudspaces: Create, list, get, and delete Kubernetes clusters
• Spot Node Pools: Manage auction-based worker nodes with bid pricing
• On-Demand Node Pools: Manage fixed-price worker nodes
• Kubeconfig: Generate kubeconfig files for kubectl access
• Pricing: Get current market prices and historical pricing data
• Read-Only Mode: Optionally hide create/delete operations for safety

Prerequisites

• Node.js 18+
• A Rackspace Spot account
• A refresh token from the Rackspace Spot console

Installation

Using npx (recommended)

No installation required - run directly with npx:

npx rackspace-spot-mcp

Global Installation

npm install -g rackspace-spot-mcp
rackspace-spot-mcp

From Source

# Clone the repository
git clone https://github.com/pm990320/rackspace-spot-mcp.git
cd rackspace-spot-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
RACKSPACE_SPOT_REFRESH_TOKEN=your-token node dist/index.js

When using a local build with Claude Desktop or Claude Code, point to the built dist/index.js:

{
  "mcpServers": {
    "rackspace-spot": {
      "command": "node",
      "args": ["/path/to/rackspace-spot-mcp/dist/index.js"],
      "env": {
        "RACKSPACE_SPOT_REFRESH_TOKEN": "your-refresh-token-here"
      }
    }
  }
}

Getting Your Refresh Token

1. Log in to the Rackspace Spot Console
2. Navigate to API Access > Terraform in the sidebar
3. Click Get New Token to generate a refresh token
4. Copy the token for use with this MCP server

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | RACKSPACE_SPOT_REFRESH_TOKEN | Yes | Your Rackspace Spot API refresh token | | RACKSPACE_SPOT_READ_ONLY | No | Set to true or 1 to hide create/delete operations |

Read-Only Mode

For safety, you can run the server in read-only mode which hides all create and delete tools:

RACKSPACE_SPOT_READ_ONLY=true npx rackspace-spot-mcp

This is recommended for exploratory use or when you want to prevent accidental modifications.

Usage with Claude Desktop

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rackspace-spot": {
      "command": "npx",
      "args": ["-y", "rackspace-spot-mcp"],
      "env": {
        "RACKSPACE_SPOT_REFRESH_TOKEN": "your-refresh-token-here"
      }
    }
  }
}

Read-Only Configuration

{
  "mcpServers": {
    "rackspace-spot": {
      "command": "npx",
      "args": ["-y", "rackspace-spot-mcp"],
      "env": {
        "RACKSPACE_SPOT_REFRESH_TOKEN": "your-refresh-token-here",
        "RACKSPACE_SPOT_READ_ONLY": "true"
      }
    }
  }
}

Usage with Claude Code

Add to your ~/.claude.json (global) or project's .claude.json:

{
  "mcpServers": {
    "rackspace-spot": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "rackspace-spot-mcp"],
      "env": {
        "RACKSPACE_SPOT_REFRESH_TOKEN": "your-refresh-token-here",
        "RACKSPACE_SPOT_READ_ONLY": "true"
      }
    }
  }
}

Available Tools

Infrastructure Discovery

| Tool | Description | |------|-------------| | list_regions | List all available Rackspace Spot regions | | get_region | Get details about a specific region | | list_server_classes | List available machine types with specs | | get_server_class | Get details about a specific server class | | list_organizations | List organizations and their namespaces |

Cloudspace Management

| Tool | Description | |------|-------------| | list_cloudspaces | List all Kubernetes clusters in a namespace | | get_cloudspace | Get details about a specific cluster | | create_cloudspace | Create a new Kubernetes cluster | | delete_cloudspace | Delete a cluster (irreversible) |

Spot Node Pools (Auction Pricing)

| Tool | Description | |------|-------------| | list_spot_node_pools | List spot node pools in a cloudspace | | get_spot_node_pool | Get details about a spot node pool | | create_spot_node_pool | Create a spot node pool with bid price | | delete_spot_node_pool | Delete a spot node pool |

On-Demand Node Pools (Fixed Pricing)

| Tool | Description | |------|-------------| | list_ondemand_node_pools | List on-demand node pools | | get_ondemand_node_pool | Get details about an on-demand pool | | create_ondemand_node_pool | Create an on-demand node pool | | delete_ondemand_node_pool | Delete an on-demand node pool |

Utilities

| Tool | Description | |------|-------------| | get_kubeconfig | Generate kubeconfig for kubectl access | | get_market_pricing | Get current market prices and capacity | | get_price_history | Get historical pricing for a server class | | get_percentile_pricing | Get price distribution data |

Example Interactions

Create a new cloudspace

"Create a new Kubernetes cluster called 'my-app' in the us-central-dfw-1 region"

Add spot nodes with bidding

"Add a spot node pool with 3 medium-sized servers, bidding $0.05 per hour"

Check pricing before bidding

"What are the current market prices for m3.medium servers in DFW?"

Get cluster access

"Generate a kubeconfig for my production cloudspace"

Development

# Watch mode for development
npm run dev

# Run type checking
npm run typecheck

# Run unit tests
npm test

# Run integration tests (requires RACKSPACE_SPOT_REFRESH_TOKEN)
RACKSPACE_SPOT_REFRESH_TOKEN=your-token npm run test:integration

# Regenerate API types from OpenAPI spec
npm run generate-client

Testing

The project includes comprehensive tests:

• Unit Tests: Test the SpotClient methods with mocked responses
• Integration Tests: Test the full MCP server including tool discovery and read-only mode
• Live API Tests: Optionally test against the real Rackspace Spot API (requires token)

Architecture

This MCP server uses a hybrid approach:

1. Generated Types: TypeScript types are auto-generated from the official Rackspace Spot OpenAPI 3.0 specification using openapi-typescript
2. Type-Safe Client: The openapi-fetch library provides a type-safe HTTP client
3. MCP Server: Built with @modelcontextprotocol/sdk for LLM integration

License

MIT

Disclaimer

This is a third-party, community-maintained MCP server and is not officially published or supported by Rackspace Technology.