Open Resource Broker

v1.0.0Cloud Servicesstable

A unified API for orchestrating and provisioning compute capacity programmatically. Define what you need in a template, request it, track it, return it — through a CLI, REST API, Python SDK, or MCP server.

open-resource-brokermcpai-integration
Share:
11
Stars
0
Downloads
0
Weekly
0/5

What is Open Resource Broker?

Open Resource Broker is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unified api for orchestrating and provisioning compute capacity programmatically. define what you need in a template, request it, track it, return it — through a cli, rest api, python sdk, or mcp serv...

A unified API for orchestrating and provisioning compute capacity programmatically. Define what you need in a template, request it, track it, return it — through a CLI, REST API, Python SDK, or MCP server.

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A unified API for orchestrating and provisioning compute cap

Use Cases

Programmatically request and provision compute capacity through templates.
Track and manage resource allocation via CLI, REST API, Python SDK, or MCP.
awslabs

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedMay 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx open-resource-broker

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Open Resource Broker

Open Resource Broker (ORB) is an AWS Labs Python package that provides a unified API for programmatically orchestrating and provisioning compute capacity through templates. It exposes a CLI, REST API, Python SDK, and MCP server interface, allowing AI assistants to request machines, track provisioning status, manage resource lifecycles, and validate infrastructure templates — all backed by AWS credentials for compute provisioning.

Prerequisites

  • Python 3.10 or newer
  • AWS credentials configured (via CLI profiles, environment variables, IAM instance roles, or AWS SSO)
  • pip for package installation
  • AWS CLI installed and 'aws sts get-caller-identity' returning successfully
  • Network access to AWS APIs from the machine running the MCP server
1

Install orb-py

Install the Open Resource Broker Python package. Use the 'all' extra to include CLI colors, REST API server, and monitoring components.

pip install "orb-py[all]"

# Or install only what you need:
pip install orb-py           # Core only
pip install "orb-py[cli]"    # With colored CLI output
pip install "orb-py[api]"    # With REST API server
2

Configure AWS credentials

Ensure AWS credentials are configured and the account has permissions to provision compute resources. Verify the setup before proceeding.

# Option 1: AWS CLI profile
aws configure

# Option 2: Environment variables
export AWS_ACCESS_KEY_ID=your_key_id
export AWS_SECRET_ACCESS_KEY=your_secret
export AWS_DEFAULT_REGION=us-east-1

# Verify credentials work
aws sts get-caller-identity
3

Configure ORB directories (optional)

Customize ORB's working directories via environment variables if you need non-default paths.

export ORB_ROOT_DIR="/path/to/orb-data"      # Base directory for all ORB subdirectories
export ORB_LOG_LEVEL="INFO"                   # DEBUG, INFO, WARNING, or ERROR
4

Start the MCP server

Launch ORB in MCP stdio mode for use with Claude Desktop, or in TCP mode for development.

# Stdio mode (for Claude Desktop and Claude Code)
orb mcp serve --stdio

# TCP mode for development and testing
orb mcp serve --port 3000 --host localhost
5

Add to Claude Desktop configuration

Register the ORB MCP server in your claude_desktop_config.json.

{
  "mcpServers": {
    "open-resource-broker": {
      "command": "orb",
      "args": ["mcp", "serve", "--stdio"],
      "env": {
        "AWS_DEFAULT_REGION": "us-east-1",
        "ORB_LOG_LEVEL": "INFO"
      }
    }
  }
}
6

Verify available templates

After connecting, check which compute templates are available in your ORB environment before making provisioning requests.

orb templates list
orb infrastructure show

Open Resource Broker Examples

Client configuration

claude_desktop_config.json entry for the Open Resource Broker MCP server in stdio mode with AWS region configured.

{
  "mcpServers": {
    "open-resource-broker": {
      "command": "orb",
      "args": ["mcp", "serve", "--stdio"],
      "env": {
        "AWS_DEFAULT_REGION": "us-east-1",
        "ORB_LOG_LEVEL": "INFO"
      }
    }
  }
}

Prompts to try

Use these prompts with Claude after connecting to the ORB MCP server to manage compute resources.

- "List all available compute templates in the resource broker"
- "Request 3 machines using the 'ml-training-large' template and track the provisioning status"
- "Check the status of request req-12345"
- "Validate my template configuration before submitting a provisioning request"
- "List all currently active machine allocations and return any idle ones"
- "Show the current infrastructure health status"

Troubleshooting Open Resource Broker

orb command not found after pip install

Ensure the Python scripts directory is on your PATH. Run 'pip show orb-py' to find the installation location, then add the scripts directory (e.g., ~/.local/bin on Linux/macOS) to your PATH in your shell profile.

AWS credentials error when starting the MCP server

Run 'aws sts get-caller-identity' to verify credentials are configured correctly. If using SSO, run 'aws sso login --profile your-profile' first. Ensure the IAM role or user has EC2 and relevant compute provisioning permissions.

No templates available after connecting

Run 'orb infrastructure discover' to scan your AWS environment for available infrastructure providers and templates. The ORB_ROOT_DIR must be writable and accessible. Check logs at the configured ORB_LOG_DIR for detailed error messages.

Frequently Asked Questions about Open Resource Broker

What is Open Resource Broker?

Open Resource Broker is a Model Context Protocol (MCP) server that unified api for orchestrating and provisioning compute capacity programmatically. define what you need in a template, request it, track it, return it — through a cli, rest api, python sdk, or mcp server. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Open Resource Broker?

Follow the installation instructions on the Open Resource Broker GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Open Resource Broker?

Open Resource Broker works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Open Resource Broker free to use?

Yes, Open Resource Broker is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "open-resource-broker": { "command": "npx", "args": ["-y", "open-resource-broker"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Open Resource Broker?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides