MAAS MCP Server

A Model Context Protocol (MCP) server for interacting with MAAS (Metal as a Service) through a standardized JSON-RPC 2.0 interface.

Introduction

The MAAS MCP Server implements the Model Context Protocol specification to enable AI assistants to interact with MAAS (Metal as a Service) infrastructure. It provides a standardized interface for machine management, network configuration, storage management, and more through a JSON-RPC 2.0 API.

This server can operate in two transport modes:

1. HTTP/HTTPS - For web-based interactions and SSE (Server-Sent Events) streaming
2. stdin/stdout - For direct integration with AI assistants and CLI tools

Installation

Prerequisites

• Go 1.22 or later
• MAAS server with API access
• MAAS API key in the format "consumer:token:secret"

With script from release

curl -sSL https://raw.githubusercontent.com/lspecian/maas-mcp-server/main/scripts/install.sh | bash

From Source

1. Clone the repository:

   git clone https://github.com/lspecian/maas-mcp-server.git
   cd maas-mcp-server
   

2. Build the server:

   ./build.sh build
   

3. Configure the server:

   cp config/config.yaml.example config/config.yaml
   cp .env.example .env
   

4. Edit config/config.yaml and update:

   • MAAS API URL
   • MAAS API key
   • Server host/port
   • Logging configuration

Environment Variables

The server requires the following environment variables:

• MAAS_API_URL - The URL of your MAAS API endpoint
• MAAS_API_KEY - Your MAAS API key in the format "consumer:token:secret"
• LOG_LEVEL - (Optional) The logging level (default: "info")
• LOG_FORMAT - (Optional) The logging format (default: "json")
• AUTH_ENABLED - (Optional) Whether authentication is enabled (default: "false")

These can be set in the .env file or directly in your environment.

Roo Integration with .roo/mcp.json

For integration with Roo, you can configure the server using the .roo/mcp.json file. Here's an example configuration:

{
  "mcpServers": {
    "maas-server": {
      "command": "./maas-mcp-server",
      "args": [
        "stdio"
      ],
      "protocol": "stdio",
      "jsonrpc": "2.0",
      "readyMessage": "MCP server ready",
      "env": {
        "MAAS_API_URL": "http://your-maas-server:5240/MAAS",
        "MAAS_API_KEY": "consumer:token:secret",
        "LOG_LEVEL": "debug",
        "LOG_FORMAT": "json",
        "AUTH_ENABLED": "false"
      },
      "disabled": false,
      "alwaysAllow": [
        "maas_list_machines",
        "maas_get_machine_details",
        "maas_power_on_machine",
        "maas_power_off_machine",
        "list_machines"
      ]
    }
  }
}

The environment variables in the env section are used to configure the server. The server will read these variables and use them to configure itself.

Using Docker

1. Build the Docker image:

   ./build-docker.sh
   

2. Run the container:

   docker run -p 8081:8081 -v $(pwd)/config:/app/config maas-mcp-server
   

Usage

Starting the Server

HTTP Mode

./build.sh run

The server will be available at http://localhost:8081/mcp.

stdin/stdout Mode

./build.sh run-mcp-stdio

Or directly:

./maas-mcp-server stdio

In this mode, the server reads JSON-RPC requests from stdin and writes responses to stdout, making it suitable for integration with AI assistants.

Version Information

To display the version information:

./maas-mcp-server --

... [View full README on GitHub](https://github.com/lspecian/maas-mcp-server#readme)