Dokumentation

MCP Fusion/Integrations and federation/AWS-Konnektoren

AWS-Konnektoren

Frag die KI über Vinkius

Stellen Sie markierte AWS-Lambda-Funktionen und Step Functions mit typisierten Adaptern, deterministischer Erkennung und MVA-Interception rund um die Payload als MCP-Tools bereit.

Die eigentliche Geschäftslogik läuft häufig bereits in AWS. Das AWS-Paket von MCP Fusion stellt einem Agenten eine typisierte MCP-Oberfläche über Lambda-Funktionen und Step Functions bereit und hält Erkennung, Anmerkungen und Antwortaufbereitung an einer einzigen Konnektorgrenze zusammen.

Lambda-Erkennung

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));
}

Die geprüfte Konnektorkonfiguration akzeptiert einen optionalen Lambda-Client, einen Step-Functions-Client, einen Tag-Filter, enableLambda (Standard true), enableStepFunctions (Standard false), pollInterval, onChange und onError. Die Erkennung erfolgt absichtlich nur über Tags: Der Standardfilter verlangt mcp:expose=true.

Tags sind die AWS-Zulassungsliste

Das Paket definiert Tag-Schlüssel für Freigabe, Gruppe, Aktion, Nur-Lesen, destruktives Verhalten und den Step-Functions-Typ:

TagMeaning
mcp:expose=truefür die Erkennung geeignet
mcp:groupMCP-Namespace
mcp:actionAktionsname innerhalb des Namespace
mcp:readOnlyNur-Lesen-Anmerkung
mcp:destructiveAnmerkung für destruktives Verhalten
mcp:sfn-typeAusführungsmodus von Step Functions

LambdaDiscovery und StepFunctionDiscovery erzeugen Zusammenfassungen, anschließend erzeugen synthesizeLambdaTools und synthesizeStepFunctionTools die Tool-Konfigurationen. synthesizeAll verbindet die erkannte Menge, und toToolName gibt ihr einen stabilen MCP-Namen.

Manuelle AWS-Tools

Die Erkennung ist nicht der einzige Weg. Für eine kritische Funktion, deren Vertrag sich bei Änderungen der Tags nicht ändern soll, definieren Sie sie direkt:

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,
  },
});

Die manuelle Konfiguration erfordert den ARN und akzeptiert eine Beschreibung sowie MCP-Anmerkungen. Die zurückgegebene Konfiguration benötigt weiterhin die normale Zusammensetzung aus Registry, Presenter und Middleware.

Step Functions

Setzen Sie enableStepFunctions: true und stellen Sie den Step-Functions-Client bereit. Der Adapter stellt je nach erkanntem mcp:sfn-type-Tag eine synchrone oder asynchrone Ausführung bereit. Die MVA-Grenze fängt die AWS-Payload ab, bevor sie für das Modell sichtbar wird: Die erzeugte Aktion kann wie ein handgeschriebenes Tool einen Presenter anhängen und Felder redigieren.

AWS-Anmeldedaten und Tenant-Grenzen

Das AWS-Paket entscheidet weder über Ihre IAM-Richtlinie noch über Ihre Tenant-Zuordnung. Erstellen Sie den Client mit den Anmeldedaten und der Region, die Ihre Bereitstellung verwenden darf, lösen Sie die Tenant-Identität in contextFactory auf und halten Sie kontospezifische Kennungen aus modellgesteuerten Argumenten heraus. Wenn die Funktion einen vom Käufer bereitgestellten Anbieterschlüssel benötigt, verwenden Sie BYOC credentials, kein Feld im Tool-Schema.

Das README enthält ältere Beispiele mit nicht exportierten Erkennungsnamen. Das Source-Barrel ist maßgeblich: Verwenden Sie createAwsConnector, defineAwsTool, die Adapter, Erkennungsklassen und die oben aufgeführten Synthesefunktionen.

Nächste Schritte