Skip to main content

MCP Servers

Cloudaware provides several MCP servers for different purposes.

  • Cloudaware MCP Server to query data in your Cloudaware CMDB. This server is available with HTTP transport and Stdio transport through repo-manager
  • repo-manager MCP Server

Cloudaware MCP Server

Overview​

The CloudAware MCP (Metadata and Query Proxy) Server provides a secure interface for discovering and querying metadata and data from your CloudAware datasets stored in Google BigQuery. It enables programmatic access to object types, fields, relationships, and direct SQL query execution, helping you explore and analyze your cloud infrastructure data efficiently. Note that the server is currently under active development, and its features, APIs, and behaviors may evolve significantly in future releases. For the latest updates, refer to the release notes or contact support.

Tools Overview​

The server exposes a set of tools via a JSON-RPC interface for metadata discovery and data querying. These tools are designed to be used in a step-by-step manner:

  • search_types: Search for object types based on keywords to identify API names and table IDs.
  • search_fields: Retrieve field metadata for a specific type, including labels, types, and descriptions.
  • get_relationship_graph: Get a graph of relationships starting from a type to understand joins.
  • execute_query: Run custom BigQuery SQL queries on your dataset.

AI agent should follow a discovery-first approach: start with type and field searches before querying data. Detailed tool descriptions, inputs, and outputs are available in the API reference (accessible via the server's endpoint).

sdtio Transport​

The MCP Server supports local operation though stdio transport.

The server is run through the repo-manager tool.

This server uses:

You have to set up both authentication profiles before using the server.

Gemini CLI​

Add following to your ~/.gemini/settings.json:

{
  "mcpServers": {
    "cloudaware-mcp": {
      "command": "repo-manager",
      "args": ["mcp", "cloudaware"]
    }
  }
}

Or in case you haven't created alias for repo-manager:

{
  "mcpServers": {
    "cloudaware-mcp": {
      "command": "java",
      "args": ["-jar", "path/to/your/repo-manager.jar", "mcp", "cloudaware"]
    }
  }
}

HTTP Transport Running Locally​

Similarly to stdio transport, you can run the server locally with repo-manager mcp cloudaware --port 8888. This will start the server on port 8888.

LM Studio​

Edit mcp.json and add following:

{
  "mcpServers": {
    "cloudaware-mcp": {
      "url": "http://localhost:8888/mcp"
    }
  }
}

HTTP Transport With OAuth​

For tools that support integration with HTTP transport and OAuth authentication, you can use the server's endpoint URL to make requests directly.

Configuration Parameters:

  • Server URL: https://inbound.prod.cloudaware.com/mcp
  • Export Project ID: set via X-CA-ExportProject header
  • SObjects Dataset Name: set via X-CA-SObjectsDataset header

Server uses Google OAuth 2.0 for authentication. You must have required permissions to access SObjects dataset in Export Project.

Gemini CLI​

Add following to your ~/.gemini/settings.json:

{
  "mcpServers": {
    "cloudaware-mcp": {
      "httpUrl": "https://inbound.prod.cloudaware.com/mcp",
      "headers": {
        "X-CA-ExportProject": "your-export-project-id",
        "X-CA-SObjectsDataset": "your-sobjects-dataset-name"
      }
    }
  }
}

Start Gemini CLI and run /mcp auth cloudaware-mcp to authenticate.

LibreChat​

Add the following to your librechat.yaml:

mcpServers:
  cloudaware-mcp:
    type: streamable-http
    url: https://inbound.prod.cloudaware.com/mcp?exportProject=your-export-project-id&sObjectsDataset=your-sobjects-dataset-name
    timeout: 30000
    serverInstructions: true