With apologies in advance to @sangemaru (since I did not ask permission), I've forked this project.
the git repository's source code is in a poor state
node_modules checked into source code
dist checked into source code
multiple megabytes of executables and directories not compatible across operating systems
many leftover markdown files, plans, unused files throughout
tests not working, and typescript unused
Since I used a filter-repo to clean up the git history, this made my changes incompatible with github PRs
Subset of filter-repo commands used during cleanup:
git filter-repo --force --path node_modules --invert-paths
git filter-repo --force --path dist --invert-paths
git filter-repo --force --path TESTING.md --invert-paths
git filter-repo --force --path PHASE_2_3_SUMMARY.md --invert-paths
git filter-repo --force --path .serena --invert-paths
git filter-repo --force --path FORUM_POST.md --invert-paths
git filter-repo --force --path REAL_TEST_RESULTS_F23B.md
git filter-repo --force --path TESTING_NOTES.md --invert-paths
Here is the new published package:
https://www.npmjs.com/package/@halecraft/mcp-cloudron
I separated the API surface area into 8 categories for now, and implemented a few more of the openapi spec endpoints (32 of 240 total implemented):
App Management
cloudron_list_apps - List all installed applications with status and health
cloudron_get_app - Get detailed information about a specific application
cloudron_control_app - Start, stop, or restart an application
cloudron_configure_app - Update environment variables, memory limits, access control
cloudron_install_app - Install an application from the App Store
cloudron_uninstall_app - Uninstall an application (with pre-flight validation)
cloudron_clone_app - Clone an application to a new location
cloudron_repair_app - Repair a broken application
cloudron_update_app - Update an application to a newer version
cloudron_restore_app - Restore an application from a backup
cloudron_backup_app - Create a backup of a specific application
App Store
cloudron_search_apps - Search the Cloudron App Store
cloudron_validate_manifest - Validate an app before installation
Backups
cloudron_list_backups - List all available backups
cloudron_create_backup - Create a new instance backup
Users
cloudron_list_users - List all users
cloudron_get_user - Get details for a specific user
cloudron_create_user - Create a new user with role assignment
cloudron_update_user - Update user properties (email, role, password)
cloudron_delete_user - Delete a user (with pre-flight validation)
Groups
cloudron_list_groups - List all groups
cloudron_create_group - Create a new group
System
cloudron_get_status - Get Cloudron instance status and version
cloudron_check_storage - Check available disk space
cloudron_list_services - List platform services (MySQL, PostgreSQL, etc.)
cloudron_list_domains - List configured domains
cloudron_get_logs - Retrieve application or service logs
Tasks
cloudron_task_status - Check status of an async operation
cloudron_cancel_task - Cancel a running operation
cloudron_validate_operation - Pre-flight validation for destructive operations
Updates
cloudron_check_updates - Check for Cloudron platform updates
cloudron_apply_update - Apply a platform update
I don't normally do this (I like to contribute), but I have some time constraints right now and am currently unwilling to slow down to work through some of these issues to get to baseline. That said, I do applaud your getting this started sangemaru and hope this doesn't dissuade you from continuing.
