sota

Name: sota
Author: sota-deploy

ローカル

github.com/sota-deployクラウド・インフラ023 週間前に更新

リポジトリ

sota について

sota は、sota.io で Web アプリをデプロイ、管理する MCP サーバーです。AI エージェントや MCP クライアントを使う開発者向けで、デプロイ、ログ、環境変数、プロジェクト、ロールバック、カスタムドメインを操作できます。

主な機能

01Web アプリのデプロイ
02ビルド・実行ログの表示
03環境変数の管理
04状態確認とデプロイのロールバック
05プロジェクトの作成と管理
06カスタムドメインの管理

活用シーン

01アプリのディレクトリを sota.io にデプロイ
02ログやデプロイ状態の確認
03プロジェクトの環境変数を更新
04カスタムドメインの追加や確認

MCP 対応

sota はローカルクライアント向けの stdio MCP サーバーと、リモートエンドポイントをホストする Streamable HTTP トランスポートを提供します。ツールから sota.io のプロジェクトとデプロイを管理できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "sota-deploy-sota": {
      "command": "npx",
      "args": [
        "-y",
        "@sota-io/mcp"
      ]
    }
  }
}

起動コマンドnpx -y @sota-io/mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@sota-io/mcp1.1.1stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

@sota-io/mcp

sota.io 用の MCP サーバー — AI エージェント経由でウェブアプリをデプロイします。

2 種類のトランスポート

v1.4.0 以降、このパッケージには2 種類のトランスポートが含まれています。

sota-mcp（stdio、デフォルト） — Claude Code、Cursor、Windsurf、およびローカルプロセスを起動するすべての MCP クライアント向けです。SOTA_API_KEY を環境変数で渡します。
sota-mcp-http（Streamable HTTP） — mcp.sota.io を支えるリモートエンドポイントをセルフホストするためのものです（Claude Desktop と Claude.ai ウェブ版で使用）。SUPABASE_JWT_SECRET、DATABASE_URL などを読み込みます。ほとんどのユーザーには必要ありません。独自のホストを運用する場合に備え、mcp.sota.io で稼働するコードと同じものです。

ほとんどのユーザーには、stdio トランスポートが適しています。

Claude Desktop / Claude.ai ウェブ版へのワンクリックインストール

Claude Desktop または Claude.ai（Pro / Max / Team / Enterprise プラン）を利用している場合、最も簡単なインストール方法は、この npm パッケージを使うことではなく、mcp.sota.io のホスト型リモートエンドポイントを使うことです。こちらをクリックしてください。

Claude に追加 →

認証は OAuth で行います。新規ユーザーは create_account ツールを使って、ブラウザーのタブを切り替えずに Claude 内で登録を完了できます。

https://sota.io/docs/integrations/claude を参照してください。

クイックスタート（stdio — Claude Code、Cursor、Windsurf など）

sota.io/dashboard/settings から API キーを取得します
IDE を設定します
AI に 「アプリを sota.io にデプロイして」 と依頼します

インストール

インストールは不要です — npx で直接実行します。

npx -y @sota-io/mcp

または、グローバルにインストールします。

npm install -g @sota-io/mcp
sota-mcp

設定

Claude Code

CLI で設定する方法：

claude mcp add sota -- npx -y @sota-io/mcp

次に、シェル環境で API キーを設定します。

export SOTA_API_KEY=sota_your_api_key_here

手動で JSON を設定する方法（.claude/settings.json）：

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json を編集します。

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Cursor

プロジェクトのルートに .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

ツール

ツール	説明	パラメーター
`deploy`	アプリをデプロイします	`project_id`、`directory?`
`get-logs`	ビルド／実行時のログを取得します	`project_id`、`deployment_id?`
`set-env`	環境変数を設定します	`project_id`、`key`、`value`
`get-env`	環境変数の一覧を取得します	`project_id`
`rollback`	以前のデプロイにロールバックします	`project_id`
`get-status`	デプロイのステータスを取得します	`project_id`
`list-projects`	すべてのプロジェクトを一覧表示します	(なし)
`create-project`	新しいプロジェクトを作成します	`name`
`delete-project`	プロジェクトを完全に削除します	`project_id`
`add-domain`	プロジェクトにカスタムドメインを追加します	`project_id`、`domain`
`list-domains`	カスタムドメインを一覧表示します	`project_id`
`get-domain`	ドメインの詳細と DNS のステータスを取得します	`project_id`、`domain_id`
`remove-domain`	カスタムドメインを削除します	`project_id`、`domain_id`

`deploy`

アプリケーションを sota.io にデプロイします。指定したディレクトリの tar.gz アーカイブを作成し、アップロードします。

パラメーター	型	必須	説明
`project_id`	string	はい	デプロイ先のプロジェクト ID
`directory`	string	いいえ	デプロイするディレクトリ（デフォルトは現在の作業ディレクトリ）

"Deploy my app in the current directory to sota.io"

`get-logs`

デプロイメントのビルドログとランタイムログを取得します。deployment_id が指定されていない場合は、最新のデプロイメントのログを返します。

Parameter	Type	Required	Description
`project_id`	string	Yes	ログを取得するプロジェクトの ID
`deployment_id`	string	No	特定のデプロイメント ID（デフォルトは最新のデプロイメント）

"Show me the build logs for my sota.io project"

`set-env`

プロジェクトの環境変数を設定します。

Parameter	Type	Required	Description
`project_id`	string	Yes	プロジェクト ID
`key`	string	Yes	環境変数名（例：DATABASE_URL）
`value`	string	Yes	環境変数の値

"Set DATABASE_URL on my project to postgres://localhost/mydb"

`get-env`

プロジェクトの環境変数を一覧表示します。

Parameter	Type	Required	Description
`project_id`	string	Yes	プロジェクト ID

"Show all environment variables for my project"

`rollback`

プロジェクトを前回のデプロイメントにロールバックします。再ビルドせずにコンテナイメージを切り替えます。

Parameter	Type	Required	Description
`project_id`	string	Yes	ロールバックするプロジェクトの ID

"Roll back my app to the previous version"

`get-status`

URLや最近のデプロイメント履歴など、プロジェクトの現在のデプロイメントステータスを取得します。

Parameter	Type	Required	Description
`project_id`	string	Yes	ステータスを確認するプロジェクトの ID

"What's the status of my sota.io deployment?"

`list-projects`

sota.io アカウント上のすべてのプロジェクトを一覧表示します。

パラメーターは不要です。

"List my sota.io projects"

`create-project`

sota.io に新しいプロジェクトを作成します。プロジェクトのスラッグは名前から自動生成され（小文字、ハイフン区切り、最大 63 文字）、サブドメイン（{slug}.sota.io）として使用されます。たとえば、「My API」は my-api.sota.io になります。

Parameter	Type	Required	Description
`name`	string	Yes	新しいプロジェクトの名前

"Create a new sota.io project called my-api"

`delete-project`

sota.io からプロジェクトとそのすべてのデプロイメントを削除します。この操作は取り消せません。

Parameter	Type	Required	Description
`project_id`	string	Yes	削除するプロジェクトの ID

"Delete my sota.io project abc123"

`add-domain`

プロジェクトにカスタムドメインを追加します。ドメインの向き先を設定するための DNS 手順を返します。

Parameter	Type	Required	Description
`project_id`	string	Yes	プロジェクト ID
`domain`	string	Yes	ドメイン名（例：「example.com」または「app.example.com」）

"Add example.com as a custom domain to my project"

`list-domains`

プロジェクトのすべてのカスタムドメインを一覧表示します。

Parameter	Type	Required	Description
`project_id`	string	Yes	プロジェクト ID

"Show all custom domains for my project"

`get-domain`

DNS の検証ステータスや SSL の状態など、ドメインの詳細を取得します。

Parameter	Type	Required	Description
`project_id`	string	Yes	プロジェクト ID
`domain_id`	string	Yes	ドメイン ID

"Check the DNS status of my custom domain"

`remove-domain`

プロジェクトからカスタムドメインを削除します。

Parameter	Type	Required	Description
`project_id`	string	Yes	プロジェクト ID
`domain_id`	string	Yes	削除するドメインの ID

"Remove the custom domain from my project"

環境変数

Variable	Required	Default	Description
`SOTA_API_KEY`	Yes	—	`sota_` プレフィックス付きの API キー。sota.io/dashboard/settings で作成できます
`SOTA_API_URL`	No	`https://api.sota.io`	API のベース URL

トラブルシューティング

「npx: command not found」

問題： お使いの IDE は、nvm/fnm が読み込まれるシェルの PATH を引き継いでいません。

解決方法： npx の絶対パスを使用します。次のコマンドで確認してください。

which npx
# Example output: /Users/you/.nvm/versions/node/v22.0.0/bin/npx

次に、MCP 設定を更新し、絶対パスを使用します。

{
  "mcpServers": {
    "sota": {
      "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

"SOTA_API_KEY environment variable is required"

問題： MCP の設定に API キーが設定されていません。

修正方法： MCP サーバーの設定に env ブロックを追加してください。シェルの環境変数は MCP サーバーに自動的には渡されないため、設定に env ブロックが必要です：

{
  "env": {
    "SOTA_API_KEY": "sota_your_api_key_here"
  }
}

接続拒否またはタイムアウトエラー

問題： ネットワークの問題、または API URL が間違っています。

修正方法： インターネット接続を確認してください。カスタム API URL を使用している場合は、SOTA_API_URL が正しく設定されていることを確認してください。デフォルトは https://api.sota.io です。

ライセンス

MIT

リンク

Markdown 対応

ログインしてコメント

基本情報

作者: sota-deploy
言語: node
バージョン: 1.1.1
トランスポート: stdio
掲載日: 2026年3月1日
最終更新: 23 週間前
公式 Registry: io.github.sota-deploy/sota

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

sota

sota について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@sota-io/mcp

2 種類のトランスポート

Claude Desktop / Claude.ai ウェブ版へのワンクリックインストール

クイックスタート（stdio — Claude Code、Cursor、Windsurf など）

インストール

設定

Claude Code

Claude Desktop

Cursor

Windsurf

ツール

deploy

get-logs

set-env

get-env

rollback

get-status

list-projects

create-project

delete-project

add-domain

list-domains

get-domain

remove-domain