Skip to main content
Glama
guilhermebkel

better-caprover-mcp

by guilhermebkel
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

better-caprover-mcp

An MCP server for CapRover, run with npx or Docker. Unofficial: not affiliated with CapRover and unrelated to the caprover-mcp project.

It lets an agent (Claude, Cursor, Codex) operate a CapRover server, with setup in one command and safety by default: the server starts in readonly mode.

Status

Bootstrap. The server starts, answers initialize and exposes no operation yet. What is planned, in order: the operations of the CapRover API in a single manifest, two ways of exposing them (named tools, and Code Mode with search and execute), access modes with confirmation for destructive calls, and diagnostics. The decisions are in docs/adr/ and the rules the operations will follow are in docs/mcp-standards.md.

Related MCP server: easypanel-mcp-server

Run it

With npx, in the client configuration (Claude Desktop and Cursor use this format; in Claude Code, claude mcp add caprover -- npx -y better-caprover-mcp):

{
  "mcpServers": {
    "caprover": {
      "command": "npx",
      "args": ["-y", "better-caprover-mcp"],
      "env": { "CAPROVER_MCP_MODE": "readonly" }
    }
  }
}

With Docker (-i is required: the server talks over stdin and stdout):

{
  "mcpServers": {
    "caprover": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "CAPROVER_MCP_MODE", "ghcr.io/guilhermebkel/better-caprover-mcp:latest"],
      "env": { "CAPROVER_MCP_MODE": "readonly" }
    }
  }
}

The package and the image are not published yet; until then, build them from this repository (below).

Variable

Default

Meaning

CAPROVER_MCP_MODE

readonly

readonly, operate or admin: how much the server may do

The variables that connect to your CapRover (CAPROVER_URL, CAPROVER_PASSWORD) arrive with the first operation. The CapRover password gives full access, so the modes are enforced by this server, not by CapRover.

Development

Needs the Node version in .nvmrc and pnpm.

nvm use
pnpm install
pnpm check   # typecheck, lint, dead code, duplication, tests, build and a smoke run of the bundle

pnpm smoke -- docker run -i --rm <image> runs the same smoke test against an image. Read AGENTS.md first: it says what to read for each kind of task.

License

MIT. See LICENSE.

Deploy Server
Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-devtools

    marin1321
    A
    license
    B
    quality
    D
    maintenance
    Production-grade MCP server that gives AI agents safe access to your local dev environment: filesystem, databases, processes, and OpenAPI specs.
    15
    33 npm
    3
    MIT

  • easypanel-mcp-server

    helbertparanhos
    A
    license
    B
    quality
    B
    maintenance
    MCP Server for full Easypanel control via Claude Code, Cursor, and Claude Desktop. Provides 37 tools for deploy, logs, env vars, domains, databases, and monitoring with built-in safety guards.
    57
    222 npm
    4
    MIT

  • infra-mcp

    odanree
    A
    license
    A
    quality
    D
    maintenance
    MCP server that wraps Docker, Caddy, and GitHub Actions operations on a remote VPS, enabling Claude to take read-then-write-with-confirmation infrastructure actions over SSH with a service allowlist and audit-trail-friendly responses.
    8
    MIT

  • clever-code-mode-mcp

    davlgd
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that gives AI agents full access to the Clever Cloud API through three tools: search, execute, and doc, using a code mode pattern to compose API commands.
    4
    Apache 2.0