From 59e6d4bb87cb03a381aaae144e19a0c7339d912e Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 00:51:56 +0530 Subject: [PATCH 01/12] Add CreateOS MCP plugin Added plugin.json file for CreateOS MCP with metadata and configuration. --- createos-mcp/.cursor-plugin/plugin.json | 48 +++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 createos-mcp/.cursor-plugin/plugin.json diff --git a/createos-mcp/.cursor-plugin/plugin.json b/createos-mcp/.cursor-plugin/plugin.json new file mode 100644 index 0000000..bee9639 --- /dev/null +++ b/createos-mcp/.cursor-plugin/plugin.json @@ -0,0 +1,48 @@ +{ + "name": "createos-mcp", + "displayName": "CreateOS MCP", + "version": "1.0.0", + "description": "Deploy and manage full-stack applications from your editor. 85+ MCP tools for GitHub repos, Docker containers, AI agents, and more with environments, domains, security scanning, analytics, and a template marketplace.", + "author": { + "name": "NodeOps", + "email": "naman@nodeops.xyz" + }, + "publisher": "NodeOps", + "homepage": "https://createos.nodeops.network", + "repository": "https://github.com/NodeOps-app/createos-mcp", + "license": "MIT", + "keywords": [ + "deployment", + "hosting", + "cloud", + "docker", + "github", + "devops", + "infrastructure", + "mcp", + "createos", + "nodeops", + "ai-agents", + "databases", + "security", + "domains", + "environments", + "analytics" + ], + "category": "cloud-infrastructure", + "tags": [ + "deployment", + "cloud", + "mcp-server", + "devops", + "ai-agents" + ], + "skills": "./skills/", + "agents": "./agents/", + "rules": "./rules/", + "mcpServers": { + "createos-mcp": { + "url": "https://api-createos.nodeops.network/mcp" + } + } +} From ae53a0e84fa59f7af48c7c8dd41fb76112073ade Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 00:54:15 +0530 Subject: [PATCH 02/12] Add SKILL.md for deployment instructions Document the deployment process for applications to CreateOS. --- createos-mcp/skills/deploy/SKILL.md | 37 +++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 createos-mcp/skills/deploy/SKILL.md diff --git a/createos-mcp/skills/deploy/SKILL.md b/createos-mcp/skills/deploy/SKILL.md new file mode 100644 index 0000000..4099eb3 --- /dev/null +++ b/createos-mcp/skills/deploy/SKILL.md @@ -0,0 +1,37 @@ +--- +name: deploy +description: Deploy applications to CreateOS from GitHub repos, Docker images, or file uploads +--- + +# Deploy + +## Trigger + +User wants to deploy, host, ship, launch, or put an application online. + +## Workflow + +1. Check existing projects: `ListProjects` to avoid duplicates. +2. Determine deployment type: + - **GitHub repo** — use `ListConnectedGithubAccounts`, then `ListGithubRepositories` to find the repo. Create a VCS project with `CreateProject` (type: "vcs"). + - **Docker image** — create an image project with `CreateProject` (type: "image"), then `CreateDeployment` with the image reference. + - **File upload** — create an upload project with `CreateProject` (type: "upload"), then use `UploadDeploymentFiles` or `UploadDeploymentBase64Files`. +3. Create an environment if none exists: `CreateProjectEnvironment` with resource limits (CPU: 200-500m, Memory: 500-1024MB, Replicas: 1-3). +4. Set environment variables: `UpdateProjectEnvironmentEnvironmentVariables` for secrets and config. +5. Deploy: `CreateDeployment` or `TriggerLatestDeployment`. +6. Monitor build: `GetBuildLogs` until status is "deployed" or "failed". +7. If failed, inspect logs and retry: `GetDeploymentLogs`, then `RetriggerDeployment`. +8. Add a custom domain if needed: `CreateDomain`, then `RefreshDomain` for TLS. + +## Guardrails + +- Always check for existing projects before creating new ones. +- Use environment variables for secrets — never hardcode credentials in source. +- Validate project names: 4-32 chars, alphanumeric with hyphens only. +- Confirm destructive operations (delete project/deployment) with the user first. + +## Output + +- Project ID and deployment URL +- Build status and any errors +- Environment configuration summary From 5f3d8fa9e8ac9e65658e4173992fbb7fc0786b45 Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 00:57:11 +0530 Subject: [PATCH 03/12] Create SKILL.md for managing environments Added documentation for managing environments, including workflows and guardrails. --- .../skills/manage-environments/SKILL.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 createos-mcp/skills/manage-environments/SKILL.md diff --git a/createos-mcp/skills/manage-environments/SKILL.md b/createos-mcp/skills/manage-environments/SKILL.md new file mode 100644 index 0000000..a6e888f --- /dev/null +++ b/createos-mcp/skills/manage-environments/SKILL.md @@ -0,0 +1,31 @@ +--- +name: manage-environments +description: Create and configure staging, production, and custom environments with variables and resources +--- + +# Manage Environments + +## Trigger + +User wants to set up staging, production, or custom environments, configure environment variables, or adjust resource limits. + +## Workflow + +1. List current environments: `ListProjectEnvironments` for the target project. +2. Create a new environment if needed: `CreateProjectEnvironment` with name, branch, and resource allocation. +3. Configure environment variables: `UpdateProjectEnvironmentEnvironmentVariables` with key-value pairs. +4. Adjust resources: `UpdateProjectEnvironmentResources` (CPU: 200-500 millicores, Memory: 500-1024 MB, Replicas: 1-3). +5. Assign a deployment: `AssignDeploymentToProjectEnvironment` to route traffic. +6. Check logs: `GetProjectEnvironmentLogs` to verify the environment is healthy. + +## Guardrails + +- Keep production and staging environments separate with distinct variables. +- Never copy production secrets to staging without user confirmation. +- Resource limits: CPU min 200m / max 500m, Memory min 500MB / max 1024MB, Replicas min 1 / max 3. + +## Output + +- Environment ID and configuration summary +- Resource allocation details +- Environment variable list (names only, not values) From a94cea805b130aea856df48e93cb11699e21bd13 Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 01:35:39 +0530 Subject: [PATCH 04/12] Add MIT License to the project --- createos-mcp/LICENSE | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 createos-mcp/LICENSE diff --git a/createos-mcp/LICENSE b/createos-mcp/LICENSE new file mode 100644 index 0000000..a7b89bc --- /dev/null +++ b/createos-mcp/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2025 NodeOps + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. From 42f41b61cf102570a827061a1cab594ba8e0be5e Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 02:17:53 +0530 Subject: [PATCH 05/12] Add initial changelog for version 1.0.0 --- createos-mcp/CHANGELOG.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 createos-mcp/CHANGELOG.md diff --git a/createos-mcp/CHANGELOG.md b/createos-mcp/CHANGELOG.md new file mode 100644 index 0000000..d4be47b --- /dev/null +++ b/createos-mcp/CHANGELOG.md @@ -0,0 +1,11 @@ +# Changelog + +## 1.0.0 + +- Initial release +- 85+ MCP tools for full-stack deployment management +- Skills: deploy, manage-environments, security-scan +- Agent: deployment-monitor for background build tracking +- Rules: CreateOS best practices +- Support for GitHub, Docker, and file-based deployments +- 11 runtimes and 15 frameworks supported From 12a916beac2acfeefd06e72e2a74a874db82f56d Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 02:41:39 +0530 Subject: [PATCH 06/12] Delete .cursor-plugin/marketplace.json --- .cursor-plugin/marketplace.json | 37 --------------------------------- 1 file changed, 37 deletions(-) delete mode 100644 .cursor-plugin/marketplace.json diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json deleted file mode 100644 index 918bb39..0000000 --- a/.cursor-plugin/marketplace.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "name": "cursor-plugins", - "owner": { - "name": "Cursor", - "email": "plugins@cursor.com" - }, - "metadata": { - "description": "Official Cursor plugin marketplace: developer tools, framework rules, MCP integrations, and agent skills" - }, - "plugins": [ - { - "name": "teaching", - "source": "teaching", - "description": "Skill mapping, practice plans, and learning retrospectives." - }, - { - "name": "continual-learning", - "source": "continual-learning", - "description": "Incremental transcript-driven memory updates for AGENTS.md using high-signal bullet points only." - }, - { - "name": "cursor-team-kit", - "source": "cursor-team-kit", - "description": "Internal team workflows used by Cursor developers for CI, code review, and shipping." - }, - { - "name": "create-plugin", - "source": "create-plugin", - "description": "Scaffold and validate new Cursor plugins." - }, - { - "name": "ralph-loop", - "source": "ralph-loop", - "description": "Iterative self-referential AI loops using the Ralph Wiggum technique." - } - ] -} From d28cafad5049a9093d7094b3e97275f913f185b7 Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 02:44:47 +0530 Subject: [PATCH 07/12] Create marketplace.json for Cursor plugins Added a new marketplace configuration for Cursor plugins, including various plugin details and descriptions. --- .cursor-plugin/marketplace.json | 42 +++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 .cursor-plugin/marketplace.json diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json new file mode 100644 index 0000000..d70f34e --- /dev/null +++ b/.cursor-plugin/marketplace.json @@ -0,0 +1,42 @@ +{ + "name": "cursor-plugins", + "owner": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "metadata": { + "description": "Official Cursor plugin marketplace: developer tools, framework rules, MCP integrations, and agent skills" + }, + "plugins": [ + { + "name": "teaching", + "source": "teaching", + "description": "Skill mapping, practice plans, and learning retrospectives." + }, + { + "name": "continual-learning", + "source": "continual-learning", + "description": "Incremental transcript-driven memory updates for AGENTS.md using high-signal bullet points only." + }, + { + "name": "cursor-team-kit", + "source": "cursor-team-kit", + "description": "Internal team workflows used by Cursor developers for CI, code review, and shipping." + }, + { + "name": "create-plugin", + "source": "create-plugin", + "description": "Scaffold and validate new Cursor plugins." + }, + { + "name": "ralph-loop", + "source": "ralph-loop", + "description": "Iterative self-referential AI loops using the Ralph Wiggum technique." + }, + { + "name": "createos-mcp", + "source": "createos-mcp", + "description": "Deploy and manage full-stack applications with 85+ MCP tools. GitHub repos, Docker, AI agents, environments, domains, security, and analytics." + } + ] +} From 94b6d896a70000763512e260706bfeec72f83297 Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 13:46:39 +0530 Subject: [PATCH 08/12] Update plugin.json with new author and metadata --- createos-mcp/.cursor-plugin/plugin.json | 46 +++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/createos-mcp/.cursor-plugin/plugin.json b/createos-mcp/.cursor-plugin/plugin.json index bee9639..1026f72 100644 --- a/createos-mcp/.cursor-plugin/plugin.json +++ b/createos-mcp/.cursor-plugin/plugin.json @@ -6,6 +6,14 @@ "author": { "name": "NodeOps", "email": "naman@nodeops.xyz" + },{ + "name": "createos-mcp", + "displayName": "CreateOS MCP", + "version": "1.0.0", + "description": "Deploy and manage full-stack applications from your editor. 85+ MCP tools for GitHub repos, Docker containers, AI agents, and more with environments, domains, security scanning, analytics, and a template marketplace.", + "author": { + "name": "NodeOps", + "email": "naman@nodeops.network" }, "publisher": "NodeOps", "homepage": "https://createos.nodeops.network", @@ -45,4 +53,42 @@ "url": "https://api-createos.nodeops.network/mcp" } } +} "publisher": "NodeOps", + "homepage": "https://createos.nodeops.network", + "repository": "https://github.com/NodeOps-app/createos-mcp", + "license": "MIT", + "keywords": [ + "deployment", + "hosting", + "cloud", + "docker", + "github", + "devops", + "infrastructure", + "mcp", + "createos", + "nodeops", + "ai-agents", + "databases", + "security", + "domains", + "environments", + "analytics" + ], + "category": "cloud-infrastructure", + "tags": [ + "deployment", + "cloud", + "mcp-server", + "devops", + "ai-agents" + ], + "skills": "./skills/", + "agents": "./agents/", + "rules": "./rules/", + "mcpServers": { + "createos-mcp": { + "url": "https://api-createos.nodeops.network/mcp" + } + } } From 163788ecc64512321710840c604d53bf749c036f Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 13:53:14 +0530 Subject: [PATCH 09/12] Create documentation for security scan skill Added documentation for the security scan skill, including trigger, workflow, guardrails, and output details. --- createos-mcp/skills/security-scan/SKILL.md | 30 ++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 createos-mcp/skills/security-scan/SKILL.md diff --git a/createos-mcp/skills/security-scan/SKILL.md b/createos-mcp/skills/security-scan/SKILL.md new file mode 100644 index 0000000..ef1a1f0 --- /dev/null +++ b/createos-mcp/skills/security-scan/SKILL.md @@ -0,0 +1,30 @@ +--- +name: security-scan +description: Run and review security scans on deployed applications +--- + +# Security Scan + +## Trigger + +User wants to check security, run a vulnerability scan, or review security results for a deployment. + +## Workflow + +1. Identify the target deployment: `ListDeployments` for the project. +2. Trigger a scan: `TriggerSecurityScan` on the deployment. +3. Wait and check results: `GetSecurityScan` to retrieve findings. +4. Download the full report if needed: `GetSecurityScanDownloadUri`. +5. If issues found, summarize findings and suggest fixes. + +## Guardrails + +- Always run scans after new deployments to production. +- Present findings clearly with severity levels. +- Do not auto-fix security issues — present recommendations and let the user decide. + +## Output + +- Scan status and summary of findings +- Severity breakdown (critical, high, medium, low) +- Recommended next steps From 0a2a737a03dae9d15736488f918544bc908881fe Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 13:55:51 +0530 Subject: [PATCH 10/12] Create deployment monitor documentation Added a deployment monitor to track CreateOS deployments, including build status and runtime health. --- createos-mcp/agents/deployment-monitor.md | 28 +++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 createos-mcp/agents/deployment-monitor.md diff --git a/createos-mcp/agents/deployment-monitor.md b/createos-mcp/agents/deployment-monitor.md new file mode 100644 index 0000000..c60ed32 --- /dev/null +++ b/createos-mcp/agents/deployment-monitor.md @@ -0,0 +1,28 @@ +--- +name: deployment-monitor +description: Monitor CreateOS deployments and report build status, errors, and runtime health. Use when waiting for a deployment to finish or when a deployment has failed. +model: fast +is_background: true +--- + +# Deployment monitor + +Deployment monitoring specialist for CreateOS. + +## Trigger + +Use when waiting for a deployment to complete, a build has failed, or when proactively checking deployment health. + +## Workflow + +1. List recent deployments: `ListDeployments` for the target project. +2. Check deployment status: `GetDeployment` for the latest deployment. +3. If building: poll status until "deployed" or "failed". +4. If failed: fetch build logs with `GetBuildLogs` and extract the root error. +5. If deployed: verify with `GetDeploymentLogs` for runtime errors. + +## Output + +- Deployment status (queued, building, deploying, deployed, failed, sleeping) +- If failed: concise error excerpt and suggested fix +- If deployed: live URL and health confirmation From 3ee30b763724952201d6162083d3df673757ee62 Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 14:05:02 +0530 Subject: [PATCH 11/12] Add best practices for CreateOS MCP deployment This document outlines best practices for deploying and managing applications using CreateOS MCP tools, including deployment operations, project management, security scans, and resource limits. --- .../rules/createos-best-practices.mdc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 createos-mcp/rules/createos-best-practices.mdc diff --git a/createos-mcp/rules/createos-best-practices.mdc b/createos-mcp/rules/createos-best-practices.mdc new file mode 100644 index 0000000..92737ed --- /dev/null +++ b/createos-mcp/rules/createos-best-practices.mdc @@ -0,0 +1,19 @@ +--- +description: Best practices for deploying and managing applications with CreateOS MCP +alwaysApply: false +--- + +# CreateOS best practices + +When deploying or managing infrastructure with CreateOS MCP tools: + +- Use CreateOS MCP tools for all deployment operations instead of manual API calls. +- Always check for existing projects with `ListProjects` before creating new ones. +- Use environment variables for secrets and configuration — never hardcode credentials. +- Create separate environments (staging, production) for proper deployment workflows. +- Run `TriggerSecurityScan` after deploying new code to production. +- Check `GetBuildLogs` when deployments fail before retrying. +- Use descriptive, lowercase names with hyphens for projects and environments (4-32 chars). +- When deploying from GitHub, verify the repo is connected via `ListConnectedGithubAccounts` first. +- Confirm destructive operations (delete project, deployment, environment) with the user before executing. +- Resource limits: CPU 200-500 millicores, Memory 500-1024 MB, Replicas 1-3. From ff5ed0d5c82480bdc1600b5ff467c00b0320263e Mon Sep 17 00:00:00 2001 From: Naman Date: Wed, 18 Mar 2026 14:10:09 +0530 Subject: [PATCH 12/12] Add README for CreateOS MCP plugin Add README for CreateOS MCP plugin with installation, components, supported runtimes, frameworks, and links. --- createos-mcp/README.md | 53 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 createos-mcp/README.md diff --git a/createos-mcp/README.md b/createos-mcp/README.md new file mode 100644 index 0000000..ad97cff --- /dev/null +++ b/createos-mcp/README.md @@ -0,0 +1,53 @@ +# CreateOS MCP plugin + +Deploy and manage full-stack applications directly from Cursor using the CreateOS platform by NodeOps. + +## Installation + +```bash +/add-plugin createos-mcp +``` + +## Components + +### Skills + +| Skill | Description | +|:------|:------------| +| `deploy` | Deploy applications from GitHub repos, Docker images, or file uploads | +| `manage-environments` | Create and configure staging, production, and custom environments | +| `security-scan` | Run and review security scans on deployed applications | + +### Agents + +| Agent | Description | +|:------|:------------| +| `deployment-monitor` | Monitor deployments and report build status, errors, and runtime health | + +### Rules + +| Rule | Description | +|:-----|:------------| +| `createos-best-practices` | Best practices for deploying and managing applications with CreateOS | + +### MCP Server + +Connects to the CreateOS MCP endpoint at `https://api-createos.nodeops.network/mcp` providing 85+ tools across 14 domains: projects, deployments, environments, domains, apps, templates, API keys, security, analytics, logs, GitHub integration, file uploads, account management, and project transfers. + +## Supported runtimes + +Node.js 18/20/22, Python 3.11/3.12, Go 1.22/1.25, Rust 1.75, Bun 1.1/1.3, and static sites. + +## Supported frameworks + +Next.js, React (SPA/SSR), Vue.js (SPA/SSR), Nuxt, Astro, Remix, Express, FastAPI, Flask, Django, Gin, Fiber, and Actix. + +## Links + +- [CreateOS Dashboard](https://createos.nodeops.network) +- [GitHub Repository](https://github.com/NodeOps-app/createos-mcp) +- [NodeOps](https://nodeops.network) + +## License + +MIT