CloudGenie MCP Server

A Model Context Protocol (MCP) server implementation in Go for the CloudGenie Internal Developer Platform (IDP). This server provides AI assistants with direct access to CloudGenie's infrastructure management APIs.

Overview

This MCP server acts as a bridge between AI assistants (like Claude) and the CloudGenie backend API, enabling natural language interactions for infrastructure provisioning, resource management, and blueprint operations.

Features

• ✅ Full MCP protocol support (version 2024-11-05)
• ✅ JSON-RPC 2.0 over stdio transport
• ✅ Complete CloudGenie API integration
• ✅ Blueprint discovery and management
• ✅ Resource CRUD operations
• ✅ Health monitoring
• ✅ Infrastructure provisioning workflows

Architecture

┌─────────────┐         ┌──────────────────┐         ┌─────────────────┐
│             │  MCP    │                  │  HTTP   │                 │
│ AI Assistant│◄───────►│ MCP Server (Go)  │◄────────│ CloudGenie API  │
│  (Claude)   │ stdio   │                  │         │    Backend      │
└─────────────┘         └──────────────────┘         └─────────────────┘

Installation

Prerequisites

• Go 1.21 or higher
• CloudGenie backend API running (or access to a hosted instance)

Build from source

# Clone the repository
git clone https://github.com/deepakvbansode/idp-cloudgenie-mcp-server.git
cd idp-cloudgenie-mcp-server

# Download dependencies
go mod download

# Build the server
go build -o cloudgenie-mcp-server .

Configuration

Environment Variables

• CLOUDGENIE_BACKEND_URL: URL of the CloudGenie backend API (default: http://localhost:8080)

Example:

export CLOUDGENIE_BACKEND_URL="https://api.cloudgenie.example.com"
./cloudgenie-mcp-server

Usage

Running the Server

The server runs in stdio mode, communicating through standard input/output:

./cloudgenie-mcp-server

MCP Client Configuration

Claude Desktop

Add to your configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "cloudgenie": {
      "command": "/path/to/cloudgenie-mcp-server",
      "env": {
        "CLOUDGENIE_BACKEND_URL": "http://localhost:8080"
      }
    }
  }
}

Other MCP Clients

Follow your client's specific configuration format for stdio-based MCP servers.

Available Tools

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "cloudgenie": {
      "command": "/path/to/cloudgenie-mcp-server"
    }
  }
}

For other MCP clients, follow their specific configuration format.

1. cloudgenie_health_check

Checks the health status of the CloudGenie backend API.

Parameters: None

Example:

{
  "name": "cloudgenie_health_check",
  "arguments": {}
}

2. cloudgenie_get_blueprints

Retrieves all available blueprints from CloudGenie.

Parameters: None

Returns: List of all blueprints with their details (ID, name, description, version, category, tags)

Example:

{
  "name": "cloudgenie_get_blueprints",
  "arguments": {}
}

3. cloudgenie_get_blueprint

Retrieves detailed information about a specific blueprint.

Parameters:

• id (string, required): The unique identifier of the blueprint

Example:

{
  "name": "cloudgenie_get_blueprint",
  "arguments": {
    "id": "blueprint-123"
  }
}

4. cloudgenie_get_resources

Retrieves all resources from CloudGenie.

Parameters: None

Returns: List of all resources with their details (ID, name, type, status, blueprint ID, timestamps)

Example:

{
  "name": "cloudgenie_get_resources",
  "arguments": {}
}

5. cloudgenie_get_resource

Retrieves detailed information about a specific resource.

Parameters:

• id (string, required): The unique identifier of the resource

Example:

{


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