Unofficial MCP server and CLI for deploying files and running SQL on cdmon hosting
Server has 7 well-defined tools with clear names (verb_noun pattern: files_list, files_read, files_upload, files_delete, db_query, db_execute, db_dump). All tools have descriptions (avg 120 chars, within 10-1024 range). Input schemas are present and use Zod validation with type definitions. However, output schemas are not documented, responses are text-only without structured field definitions. Parameter descriptions are present but minimal (avg 40 chars). Error handling is basic: dry-run pattern prevents destructive accidents, but recovery guidance is absent. Security is strong: write gates via CDMON_ALLOW_WRITES, audit logging, and no credential exposure. Composition is clean: each tool has one responsibility, and write tools default to safe dry-run mode.
Export the whole database as SQL — schema and data, every table. Read-only, so it needs no write permission. Take this before running a migration.
Run SQL that changes data or schema, one statement per request, reporting each. Writes only when dryRun is false and CDMON_ALLOW_WRITES is set.
Run a read-only query (SELECT, SHOW, DESCRIBE, EXPLAIN). Anything that changes data is refused here; use db_execute.
Delete a file from the site. Writes only when dryRun is false and CDMON_ALLOW_WRITES is set.
List a directory on the site, relative to the configured root.
Read a small text file from the site.
Output schemas not documented. Tools return text responses without structured field definitions. LLMs cannot plan downstream calls or extract typed data reliably.
Error handling lacks recovery guidance. Errors are thrown as raw exceptions without actionable next steps (e.g., 'User not found. Try search_users()' pattern absent).
Parameter descriptions are minimal (avg 40 chars). 'maxRows' lacks explanation of why it exists or what happens when exceeded. 'sql' parameter has no format guidance (single vs. multiple statements).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2026-07-28+ | v2 |
Upload text content to the site, creating parent directories. Writes only when dryRun is false and CDMON_ALLOW_WRITES is set.
db_dump has empty input schema (no parameters). Description does not explain output format (SQL dump structure, size estimate, or how to use it).
No pagination support for db_query or db_dump. Large result sets could exhaust context window. maxRows cap (1000) is high; no guidance on when to paginate or how to iterate.