serverlessrun

serverlessrun

Lambda REST API の仕様に基づいてリクエストを構成し、AWS Lambda を MCP ツールとして提供します。serverlessrun は、aws-lambda MCP サーバーの主要なインターフェースをクリーンルーム方式で再構築したもので、新しい名前を採用しています。ツール名とリクエスト形式は同じですが、コードは一から作成され、ブランド表記もコピーしていません。

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

list_functions、get_function、invoke_function、 list_versions_by_function、get_alias、list_aliases、 list_layers、get_layer_version、list_event_source_mappings、 get_account_settings。

このサブセットに含まれないもの：関数の作成／更新／削除とコードのアップロード、設定とポリシーの管理、タグ、同時実行制御、関数 URL、送信先、イベントソースマッピングへの書き込み、コード署名。

仕組み

各ツールは、仕様に記載された Lambda REST リクエスト（API バージョン 2015-03-31）を構成し、差し替え可能なエグゼキューターに渡します。 execute({ service: "lambda", operation, path, method, body, query })。 ライブラリの利用者は独自のエグゼキューターまたは署名機能を注入し、独自の署名スタックを使って実際の AWS に対して実行できます。

セットアップ

export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
export AWS_REGION=us-east-1        # optional, this is the default
export AWS_SESSION_TOKEN=...       # optional

正直な制限事項：この再構築版には独自の SigV4 署名機能は含まれていません。 認証情報を設定していても署名機能が注入されていない場合、呼び出しは SigV4 signing not configured: inject a signer/executor というエラーで失敗します。認証情報がない場合、AWS_ACCESS_KEY_ID を示すエラーで失敗します。

CLI

npx @reneturcios/serverlessrun list_functions '{}'
npx @reneturcios/serverlessrun mcp        # stdio MCP server

各ツール名がサブコマンドになっており、JSON オブジェクト引数を 1 つ受け取ります。

MCP クライアントの設定

{
  "mcpServers": {
    "serverlessrun": {
      "command": "npx",
      "args": ["-y", "@reneturcios/serverlessrun", "mcp"],
      "env": { "AWS_ACCESS_KEY_ID": "...", "AWS_SECRET_ACCESS_KEY": "..." }
    }
  }
}

Docker

docker run -i -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY ghcr.io/cloudcorprecords/serverlessrun

開発

npm install
npm run build
npm test

ライセンス

MIT