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 サーバーで、CreateOS プラットフォーム上のフルスタックアプリケーションのデプロイとインフラストラクチャ管理に対応する 85 個以上のツールを公開します。AI コーディングツールに一度接続すれば、自然言語を使ってプロジェクトのデプロイ、環境の管理、ドメインの設定、セキュリティスキャンの実行、デプロイ指標の分析などを行えます。

ダッシュボードや CLI、ドキュメントを行き来する代わりに、エディターを離れることなく、AI にインフラストラクチャを任せられます。CreateOS MCP は、*「この GitHub リポジトリからアプリをデプロイして」や「ステージング環境を 3 つのレプリカにスケーリングして」*といったプロンプトを、即座に実行される実際の操作に変換します。

Go で構築されており、パフォーマンスと信頼性を重視しています。サーバーは Streamable HTTP と stdio の両トランスポートに対応し、OAuth 2.0 と API キーによる認証を標準で利用できます。

---

特長

• 🚀 85 個以上の MCP ツール — プロジェクト、デプロイ、環境、ドメイン、テンプレートなど、CreateOS プラットフォーム API を幅広くカバー
• 🔌 9 つのクライアントに対応 — Cursor、VS Code + Copilot、Claude Desktop、Claude Code、Windsurf、Gemini CLI、Gemini Code Assist、Opencode、Zapier、ElevenLabs
• 🔐 安全な認証 — API キーと OAuth 2.0 に対応。Dynamic Client Registration (RFC 7591)、Protected Resource Metadata (RFC 9728) を利用可能
• ⚡ 2 種類のトランスポート — リモートアクセス用の Streamable HTTP、ローカル／組み込み利用向けの stdio
• 📦 あらゆるものをデプロイ — GitHub リポジトリ、Docker イメージ、ファイルアップロード（zip、base64、multipart）、マーケットプレイスのテンプレートに対応
• 🌍 環境管理 — プロジェクトごとに複数の環境を作成、設定、監視できます。シークレットとリソースはそれぞれ独立しています
• 🔒 セキュリティスキャン — 任意のデプロイでセキュリティスキャンを実行し、結果を確認できます
• 📊 組み込み分析 — 環境ごとのリクエスト指標、RPM、エラーパス、成功率、トラフィック分布を照会できます
• 🏪 テンプレートマーケットプレイス — 本番環境ですぐに使えるプロジェクトテンプレートのライブラリを閲覧、購入、デプロイできます
• 🔑 API キー管理 — API キーをプログラムから作成、一覧表示、更新、取り消しできます
• 🌐 カスタムドメイン — TLS の自動設定に対応したカスタムドメインの追加、更新、管理が可能です
• 📋 ビルドログと実行時ログ — ビルドログと実行時ログを AI アシスタントに直接ストリーミングできます

---

前提条件

1. createos.sh/app でアカウントを作成します
2. Profile Settings に移動し、API キーを生成します

📺 API キーの取得方法に関するチュートリアルを見る

---

クイックスタート

次の設定を使用して、CreateOS MCP サーバーを AI クライアントに追加します。

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

CREATEOS_API_KEY を Profile Settings で取得した実際のキーに置き換えてください。

クライアントごとのセットアップ手順については、Integration docs をご覧ください。

---

使用例

接続したら、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 フォルダー内のドキュメントに記載されているように、MCP クライアントの設定に API キーを追加するだけです。

セルフホスティング

サーバーをクローンしてビルドします。

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 の作成、一覧表示、確認、更新、コマンド実行、破棄を行います
サンドボックスディスク	CreateDisk, ListDisks, GetDisk, DeleteDisk, AttachSandboxDisk, DetachSandboxDisk, ListSandboxDisks	S3 ディスクを登録してサンドボックスに接続します
サンドボックスネットワーク	CreateNetwork, ListNetworks, GetNetwork, DeleteNetwork, AttachSandboxNetwork, DetachSandboxNetwork	プライベートサンドボックスネットワークを作成し、メンバーシップを管理します

---

ロードマップ

• データベース管理ツール（PostgreSQL、MySQL のプロビジョニングと管理）
• マネージド Kafka、Valkey/Redis 連携ツール
• Webhook とイベント駆動型のデプロイトリガー
• チームコラボレーションとロールベースのアクセスツール
• コスト見積もりと請求分析ツール
• SSE トランスポートのサポート
• デプロイのロールバックツール

---

貢献

ご貢献を歓迎します！始めるには、次の手順に従ってください。

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feat/my-feature
3. 変更を加え、テストを追加します
4. テストを実行します：go test ./...
5. わかりやすいメッセージでコミットします：git commit -m "feat: add my feature"
6. プッシュして、プルリクエストを作成します

貢献ガイドラインがある場合は、ご確認ください。

開発

MCP ツールとハンドラーは、mcpgenを使用してCreateOS OpenAPI仕様から自動生成されます。詳しくはDEVELOPMENT.mdをご覧ください。

---

行動規範

このプロジェクトは、Contributor Covenant行動規範に従っています。参加するにあたり、この行動規範を守ることが求められます。

---

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。

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.

---

謝辞

• Model Context Protocol仕様を作成したAnthropic
• 優れたGo MCP SDKを提供するmark3labs/mcp-go
• MCPの普及を推進するCursor、GitHub Copilot、Windsurf、Google Gemini、および広範なAIツールエコシステム
• デプロイメントプラットフォームを構築したCreateOSチーム

---

📚 ドキュメント全文  ·  🌐 CreateOSプラットフォーム  ·  🐛 バグを報告

役に立った場合は、スターを付けてください ✨