Createos MCP

CreateOS MCP

直接通过 AI 助手部署、管理和扩展应用。

---

简介

Model Context Protocol (MCP) 是由 Anthropic 发起的一项开放标准，让 AI 助手（Claude、Cursor、GitHub Copilot、Windsurf、Gemini 等）能够通过统一接口安全地连接外部工具、API 和服务。该项目已完整实现最新的 MCP Authorization 和 Streamable HTTP 规范。

CreateOS MCP 是一款可用于生产环境的 MCP 服务，提供 85+ 个工具，用于在 CreateOS 平台上进行全栈应用部署和基础设施管理。只需将其连接到 AI 编码工具，即可通过自然语言部署项目、管理环境、配置域名、运行安全扫描、分析部署指标等。

无需在仪表盘、CLI 和文档之间切换，你可以留在编辑器中，让 AI 处理基础设施。CreateOS MCP 可将 “从这个 GitHub 仓库部署我的应用” 或 “将暂存环境扩展到 3 个副本” 之类的提示词转化为即时执行的实际操作。

该服务使用 Go 构建，兼顾性能和可靠性，开箱即支持 Streamable HTTP 和 stdio 两种传输方式，以及 OAuth 2.0 和 API key 身份验证。

---

功能

• 🚀 85+ 个 MCP 工具 — 全面覆盖 CreateOS 平台 API：项目、部署、环境、域名、模板等
• 🔌 支持 9 个客户端 — Cursor、VS Code + Copilot、Claude Desktop、Claude Code、Windsurf、Gemini CLI、Gemini Code Assist、Opencode、Zapier 和 ElevenLabs
• 🔐 安全身份验证 — 支持 API key 和 OAuth 2.0，并提供动态客户端注册（RFC 7591）及受保护资源元数据（RFC 9728）
• ⚡ 双传输方式 — 通过 Streamable HTTP 远程访问，通过 stdio 本地或嵌入式使用
• 📦 部署各种内容 — GitHub 仓库、Docker 镜像、文件上传（zip、base64、multipart）或市场模板
• 🌍 环境管理 — 为每个项目创建、配置和监控多个环境，并为其配置独立的密钥和资源
• 🔒 安全扫描 — 对任意部署启动并查看安全扫描
• 📊 内置分析 — 按环境查询请求指标、RPM、错误路径、成功率和流量分布
• 🏪 模板市场 — 浏览、购买并部署来自生产就绪项目模板库的模板
• 🔑 API Key 管理 — 以编程方式创建、列出、更新和撤销 API key
• 🌐 自定义域名 — 绑定、刷新和管理自定义域名，并自动配置 TLS
• 📋 构建和运行时日志 — 直接在 AI 助手中查看构建日志和运行时日志

---

前置条件

1. 在 createos.sh/app 创建账户
2. 前往 Profile Settings 并生成 API key

📺 观看 API key 获取教程

---

快速开始

使用以下配置，将 CreateOS MCP 服务添加到你的 AI 客户端：

{
  "mcpServers": {
    "createos": {
      "url": "https://api-createos.nodeops.network/mcp",
      "type": "http",
      "headers": {
        "X-Api-Key": "CREATEOS_API_KEY"
      }
    }
  }
}

将 CREATEOS_API_KEY 替换为你在 个人资料设置 中获取的实际密钥。

如需针对特定客户端的设置说明，请参阅 集成文档。

---

使用示例

连接后，你可以通过 AI 助手使用自然语言与 CreateOS 交互：

部署

"Deploy my current project to CreateOS"
"Create a new project called my-api using Node.js 20"
"Deploy the main branch of my GitHub repo naman485/my-app"
"Upload this zip file as a new deployment"

管理环境

"List all environments for the my-api project"
"Set the DATABASE_URL environment variable on staging"
"Scale the production environment to 500 millicores and 1024MB memory"
"Show me the runtime logs for staging"

域名与网络

"Add a custom domain api.example.com to my project"
"Refresh the SSL certificate for my domain"
"List all domains attached to my-api"

监控与安全

"Show me the request analytics for production this week"
"What are the top error paths in staging?"
"Run a security scan on my latest deployment"
"Show me the build logs for deployment abc123"

模板与市场

"Browse available project templates"
"Deploy the FastAPI starter template"
"Create a project template from my current project"

---

配置

托管（推荐）

托管的 MCP 服务地址：

https://api-createos.nodeops.network/mcp

无需设置——只需按照 Integration 文件夹中的文档所示，将 API 密钥添加到 MCP 客户端配置中。

自托管

克隆并构建服务：

git clone https://github.com/NodeOps-app/createos-mcp.git
cd createos-mcp
go build -o createos-mcp *.go

创建 config.yaml：

port: 8080
base_url: https://your-domain.com
authorization_server_url: https://your-auth-server.com
api_base_url: https://api.createos.nodeops.network
sandbox_api_base_url: https://your-fc-control-api.example.com
transport: http       # "http" or "stdio"
log_level: debug

supported_scopes:
  - openid
  - offline_access
  - offline

response_types_supported:
  - code

grant_types_supported:
  - authorization_code
  - refresh_token

code_challenge_methods_supported:
  - S256

token_endpoint_auth_methods_supported:
  - none

运行服务：

./createos-mcp --config config.yaml

环境变量

变量	描述	必填
PORT	服务端口（覆盖配置）	否（默认值：8080）

本地测试

# Start the server
go run *.go --config config.yaml

# Open the MCP Inspector
npx @modelcontextprotocol/inspector

# In the inspector, set the URL to http://localhost:8080/mcp
# and add header X-Api-Key: YOUR_API_KEY

---

支持的工具

该服务提供 85+ 个工具，分为以下类别：

类别	工具	描述
项目	CreateProject, GetProject, ListProjects, UpdateProject, DeleteProject, UpdateProjectSettings, CheckProjectUniqueName	创建和管理项目，全面控制项目生命周期
部署	CreateDeployment, GetDeployment, ListDeployments, CancelDeployment, RetriggerDeployment, TriggerLatestDeployment, AssignDeploymentToProjectEnvironment	通过 GitHub、Docker、文件上传或 zip 部署代码
文件上传	UploadDeploymentFiles, UploadDeploymentBase64Files, UploadDeploymentZip, DownloadDeployment	提供多种代码部署上传方式
环境	CreateProjectEnvironment, ListProjectEnvironments, UpdateProjectEnvironment, DeleteProjectEnvironment, UpdateProjectEnvironmentEnvironmentVariables, UpdateProjectEnvironmentResources	管理预发布、生产和自定义环境
域名	CreateDomain, ListDomains, DeleteDomain, RefreshDomain, UpdateDomainEnvironment	支持自动 TLS 的自定义域名
应用	CreateApp, ListApps, UpdateApp, DeleteApp, AddProjectsToApp, RemoveProjectsFromApp, AddServicesToApp, RemoveServicesFromApp, ListProjectsByApp, ListServicesByApp	将项目和服务分组为逻辑应用
模板	CreateProjectTemplate, GetProjectTemplate, ListPublishedProjectTemplates, ListMyProjectTemplates, BuyProjectTemplate, DeployProjectTemplateViaGithub, UpdateProjectTemplate, DeleteProjectTemplate, DownloadProjectTemplate	用于复用项目蓝图的模板市场
API 密钥	CreateAPIKey, ListAPIKeys, UpdateAPIKey, RevokeAPIKey, CheckAPIKeyUniqueName	以编程方式管理 API 密钥
安全	TriggerSecurityScan, RetriggerSecurityScan, GetSecurityScan, GetSecurityScanDownloadUri	对部署进行自动安全扫描
分析	GetProjectEnvironmentAnalytics, OverallRequests, RPM, RequestDistribution, RequestsOverTime, SuccessPercentage, TopErrorPaths, TopHitPaths	实时请求指标和流量分析
日志	GetBuildLogs, GetDeploymentLogs, GetProjectEnvironmentLogs	构建时和运行时日志流
GitHub	InstallGithubApp, ListConnectedGithubAccounts, ListGithubRepositories, ListGithubRepositoryBranches, GetGithubRepositoryContent	用于基于代码仓库部署的 GitHub 集成
账户	GetCurrentUser, GetQuotas, GetSupportedProjectTypes	用户信息、配额和平台功能
转移	TransferProject, GetProjectTransferUri, ListProjectTransferHistory	在账户之间转移项目所有权
沙盒	CreateSandbox, ListSandboxes, GetSandbox, UpdateSandbox, ExecSandbox, DeleteSandbox	创建、列出、检查、更新、在沙盒 VM 中执行命令并销毁 VM
沙盒磁盘	CreateDisk, ListDisks, GetDisk, DeleteDisk, AttachSandboxDisk, DetachSandboxDisk, ListSandboxDisks	注册 S3 磁盘并将其挂载到沙盒
沙盒网络	CreateNetwork, ListNetworks, GetNetwork, DeleteNetwork, AttachSandboxNetwork, DetachSandboxNetwork	创建私有沙盒网络并管理网络成员

---

路线图

• 数据库管理工具（PostgreSQL、MySQL 配置和管理）
• 托管 Kafka、Valkey/Redis 集成工具
• Webhook 和事件驱动的部署触发器
• 团队协作和基于角色的访问工具
• 成本估算和账单分析工具
• 支持 SSE 传输
• 部署回滚工具

---

贡献

欢迎贡献！以下是开始的步骤：

1. Fork 此仓库
2. 创建 功能分支：git checkout -b feat/my-feature
3. 进行 更改并添加测试
4. 运行 测试：go test ./...
5. 提交 清晰的说明：git commit -m "feat: add my feature"
6. 推送 并创建 Pull Request

如果有，请阅读我们的贡献指南。

开发

MCP 工具和处理器使用 mcpgen 根据 CreateOS OpenAPI 规范自动生成。详情请参阅 DEVELOPMENT.md。

---

行为准则

本项目遵循贡献者公约行为准则。参与本项目即表示你应遵守此准则。

---

许可证

本项目采用 MIT 许可证。

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.

---

致谢

• 感谢 Anthropic 制定 Model Context Protocol 规范
• 感谢 mark3labs/mcp-go 提供出色的 Go MCP SDK
• 感谢 Cursor、GitHub Copilot、Windsurf、Google Gemini 以及更广泛的 AI 工具生态，推动 MCP 的普及
• 感谢 CreateOS 团队构建部署平台

---

📚 完整文档  ·  🌐 CreateOS 平台  ·  🐛 报告错误

如果觉得有用，请点亮星标 ✨