StuMason/coolify-mcp
TypeScript
Pull Request Opened
PR #172 opened: feat: add 7 new tools and expand 3 existing (38 → 45 total)
Summary
- Adds 7 new MCP tools:
storages,scheduled_tasks,delete_preview,hetzner,list_resources,health,api_control - Expands 3 existing tools:
env_vars(database support + bulk_update),github_apps(list_repos + list_branches),database_backups(delete_execution) - Covers 42 previously missing Coolify API endpoints, identified by comparing the OpenAPI spec from the v4.x branch against the existing implementation
Changes
src/types/coolify.ts — New types for storages, scheduled tasks, Hetzner cloud, and GitHub App repositories
src/lib/coolify-client.ts — 40 new client methods:
- Application/database/service persistent storage CRUD
- Application/service scheduled task CRUD + execution listing
- Application preview deletion
- Database env var CRUD + bulk update
- Backup execution deletion
- Service env var bulk update
- Hetzner cloud (locations, server types, images, SSH keys, create server)
- GitHub App repo/branch listing
- Resource listing, health check, API enable/disable
src/lib/mcp-server.ts — 7 new tools + 3 expanded tools following the project's consolidated action-parameter pattern to minimize token usage
README.md / CLAUDE.md — Updated tool count (38 → 45) and tool tables
Tests
- 42 new test cases (279 → 321 total)
- All client methods covered in
coolify-client.test.ts(HTTP method, URL, body, return value) - All methods verified in
mcp-server.test.ts(existence checks) - Coverage: 97.98% statements, 84.61% branches, 99.52% functions, 98.84% lines
Test plan
-
npm run build— clean -
npm test— 321 passed, 0 failed -
npm run lint— clean (pre-commit hooks passed) - Live smoke test against Coolify instance (deferred — no access to live server in this environment)
+1728
additions
-52
deletions
8
files changed