Skip to content

v0.1.0

Choose a tag to compare

View all tags
@blaipr blaipr released this 17 Aug 00:11
· 14 commits to main since this release
v0.1.0
64d4aa5

First release.

An MCP server and CLI for deploying files and running SQL on cdmon shared hosting, where a deploy is otherwise FTP and phpMyAdmin done by hand.

Unofficial — not affiliated with, endorsed by or supported by cdmon.

What it does

  • Files over FTP — list, read, upload and delete, confined to a configured root
  • SQL through phpMyAdmin — one statement per request, so a partial apply is never silent
  • Read-only by default — writes need CDMON_ALLOW_WRITES, and then still default to a dry run
  • Path traversal refused — every path resolves inside the root, and is never quietly clamped
  • Rate limited — operations are serialised and paced, because cdmon blocks bursts
  • Audited — every write appends a redacted JSON line
  • Same core in CI — a cdmon CLI for jobs with no model in them

Two things cdmon users need to know

Their phpMyAdmin is shared across all customers, so set CDMON_PMA_DOMAIN to your domain. Without it the login returns the domain picker and fails in a way that reads like a wrong password.

It also serves an incomplete certificate chain, so Node refuses the connection. Supply the missing intermediate via NODE_EXTRA_CA_CERTS — see docs/phpmyadmin.md. There is deliberately no option to skip verification; the database password crosses that connection.

Note that cdmon offers no FTPS (500 AUTH not understood), so the FTP password travels in the clear.

Install

Node 20+. Not published to npm:

git clone https://github.com/OpusProjects/cdmon-mcp.git
cd cdmon-mcp && npm install

See docs/installation.md for MCP client configuration and every setting.

Assets 2
Loading