mcp-simple-server

An MCP server that gives AI agents full access to the Clever Cloud API through three tools: search, execute, and doc.

Instead of exposing hundreds of individual tools (one per API endpoint), the agent discovers available commands then writes JavaScript code to compose them — a pattern Cloudflare also explored as "Code Mode", but without needing any specific infrastructure.

Important

This project is early software, don't use it on a production organisation without caution

How it works

1. The agent calls search with a keyword (e.g. "deploy application") and gets back matching commands with their parameters
2. The agent calls execute with JavaScript code that uses a pre-authenticated Clever Cloud client and the discovered commands:

const apps = await client.send(
  new commands.ListApplicationCommand({ ownerId: "orga_xxx" }),
  { signal }
);
return apps.filter(a => a.state === "RUNNING");

3. The agent calls doc to search Clever Cloud's documentation index or fetch a specific page as markdown — useful for conceptual questions the API catalog can't answer (runtimes, add-ons, deployment model, environment variables, etc.).

The code runs locally on your machine with a configurable timeout. The full @clevercloud/client command library is available — including automatic owner ID resolution, response transformation, and structured error handling.

Setup

Prerequisites

• Node.js >= 22
• A Clever Cloud API token (create one here)

Install

git clone https://github.com/CleverCloud/mcp-simple-server.git
cd mcp-simple-server

npm install
npm run generate-catalog
npm run build

Configure in Claude Code

Using the CLI:

claude mcp add clever-cloud \
  -e CLEVER_CLOUD_API_TOKEN=your-api-token \
  -- node /absolute/path/to/mcp-simple-server/dist/index.js

Or add a .mcp.json file at the root of your project:

{
  "mcpServers": {
    "clever-cloud": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-simple-server/dist/index.js"],
      "env": {
        "CLEVER_CLOUD_API_TOKEN": "${CLEVER_CLOUD_API_TOKEN}"
      }
    }
  }
}

The .mcp.json approach supports environment variable expansion (${VAR} or ${VAR:-default}), so you can keep your token in your shell environment rather than in the file itself.

Optional environment variables

Variable	Default	Description
CC_MCP_TIMEOUT_MS	30000	Execution timeout in milliseconds
CC_MCP_MAX_OUTPUT	50000	Maximum output length in characters

License

Apache-2.0 — Clever Cloud, 2026