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.
