cloudsession

cloudsession

MCP ツールとしてのローカル AWS セッションおよびプランの状態管理です。cloudsession は、AWS core MCP サーバーのセッション／プランのメタコアを、新しい名前でクリーンルーム方式により再構築したものです。ローカル状態のロジックを一から実装しており、コードは新規で、ブランドもコピーしていません。このサブセットのツールは AWS API を呼び出しません。セッションはプロファイル名とリージョンを保持するローカルコンテキストであり、プランは呼び出し元が明示的に進める順序付きのステップリストです。

ツール（コアサブセット、9 個）

start_session、get_session_info、end_session、set_region、 set_profile、list_regions、create_plan、advance_plan_step、 get_plan。

セッションは、上書きされない限り、プロファイル default、リージョン us-east-1 で開始され、決定的な ID（session-1、plan-1 など）が割り当てられます。リージョンは、厳選された静的リージョンリスト（29 リージョン）に照らして検証されます。セッションを終了すると、それ以降の変更はできなくなりますが、読み取りは引き続き可能です。プランでは各ステップを保留中／完了として管理します。最後のステップを進めるとプランは完了し、完了済みのプランを進めようとするとエラーになります。状態はサーバープロセスの実行中のみメモリ内に保持され、再起動後は引き継がれません。

このサブセットに含まれないもの：AWS API のプロキシ／呼び出しツール、認証情報および SSO のログインフロー、ドキュメント検索ヘルパー、プロンプトテンプレート、実際の AWS サービス API を呼び出すツール。

セットアップ

認証情報や環境変数は必要ありません。

CLI

npx @reneturcios/cloudsession list_regions '{}'
npx @reneturcios/cloudsession start_session '{"region":"eu-west-1"}'
npx @reneturcios/cloudsession mcp        # stdio MCP server

各ツール名がサブコマンドで、JSON オブジェクトを 1 つ引数に取ります。CLI を実行するたびにストアは新規作成されるため、複数ステップにわたるセッション／プランのフローには、実行中ずっと同じストアを保持する MCP サーバーを使用してください。

MCP クライアント設定

{
  "mcpServers": {
    "cloudsession": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cloudsession", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/cloudsession

開発

npm install
npm run build
npm test

ライセンス

MIT