ドキュメント

MCP Fusion/Integrations and federation/AWSコネクタ

AWSコネクタ

VinkiusについてAIに質問

タグ付き AWS Lambda 関数と Step Functions を、型付きアダプター、決定論的な検出、ペイロード周辺の MVA インターセプションを備えた MCP ツールとして公開します。

実際のビジネスロジックは、すでに AWS で動作していることがよくあります。MCP Fusion の AWS パッケージは、Lambda 関数と Step Functions の上に型付き MCP 公開面をエージェントへ提供し、検出、アノテーション、レスポンス整形を 1 つのコネクタ境界にまとめます。

Lambda の検出

typescript
import { LambdaClient } from '@aws-sdk/client-lambda';
import { createAwsConnector, createLambdaAdapter } from '@mcpfusion/aws';

const aws = await createAwsConnector({
  lambdaClient: await createLambdaAdapter(
    new LambdaClient({ region: 'us-east-1' }),
  ),
  pollInterval: 60_000,
  onChange: () => server.notification({
    method: 'notifications/tools/list_changed',
  }),
});

for (const tool of aws.tools()) {
  registry.register(defineTool(tool.name, tool.config));
}

検証済みのコネクタ設定では、オプションの Lambda クライアント、Step Functions クライアント、タグフィルター、enableLambda（デフォルト true）、enableStepFunctions（デフォルト false）、pollInterval、onChange、onError を指定できます。検出は意図的にタグによるオプトインです。デフォルトのフィルターでは mcp:expose=true が必要です。

タグが AWS の許可リストになります

このパッケージは、公開、グループ、アクション、読み取り専用、破壊的動作、Step Functions の種類に対応するタグキーを定義します。

TagMeaning
mcp:expose=true検出対象
mcp:groupMCP 名前空間
mcp:action名前空間内のアクション名
mcp:readOnly読み取り専用アノテーション
mcp:destructive破壊的動作のアノテーション
mcp:sfn-typeStep Functions の実行モード

LambdaDiscovery と StepFunctionDiscovery はサマリーを生成し、その後 synthesizeLambdaTools と synthesizeStepFunctionTools がツール設定を生成します。synthesizeAll は検出されたセットをまとめ、toToolName は安定した MCP 名を付けます。

AWS ツールを手動で定義する

検出だけが方法ではありません。タグが変わっても契約を変更したくない重要な関数では、直接定義します。

typescript
import { defineAwsTool } from '@mcpfusion/aws';

const charge = defineAwsTool({
  name: 'payments.charge',
  arn: 'arn:aws:lambda:us-east-1:123:function:charge',
  description: 'Charge an approved payment',
  annotations: {
    readOnlyHint: false,
    destructiveHint: true,
  },
});

手動設定では ARN が必須で、説明と MCP アノテーションを指定できます。返される設定には、通常のレジストリ、Presenter、ミドルウェアの組み合わせも必要です。

Step Functions

enableStepFunctions: true を設定し、Step Functions クライアントを指定します。アダプターは、検出された mcp:sfn-type タグに応じて同期または非同期の実行を公開します。MVA 境界は AWS ペイロードがモデルから見えるようになる前にインターセプトします。生成されたアクションには、手書きのツールと同じように Presenter を付け、フィールドを秘匿化できます。

AWS 認証情報とテナント境界

AWS パッケージは IAM ポリシーやテナントのマッピングを決定しません。デプロイで使用を許可された認証情報とリージョンでクライアントを作成し、contextFactory でテナント ID を解決し、アカウント固有の識別子をモデルが制御する引数から除外します。関数に購入者が提供するベンダーキーが必要な場合は、ツールスキーマのフィールドではなく BYOC credentials を使用します。

README には、エクスポートされていない検出名を使った古い例が含まれています。正式な情報源はソースの barrel です。上記の createAwsConnector、defineAwsTool、アダプター、検出クラス、合成関数を使用してください。

次のステップ