Package Exports
- @vurb/aws
Readme
@vurb/aws
MCP AWS Lambda Connector for Vurb.ts — A framework for creating MCP servers on AWS
Auto-discover Lambda & Step Functions as MCP tools · IAM integration · Multi-region
MCP AWS Connector for Vurb.ts — the Model Context Protocol framework for building production MCP servers. Auto-discovers tagged AWS Lambda & Step Functions and produces typed MCP tools — so AI agents can invoke your cloud functions natively via IAM.
Quick Start
import { initVurb } from '@vurb/core';
import { discoverLambdas } from '@vurb/aws';
const f = initVurb<AppContext>();
const registry = f.registry();
// Auto-discover Lambda functions tagged with Vurb.ts:true
await discoverLambdas(registry, {
region: 'us-east-1',
tagFilter: { 'Vurb.ts': 'true' },
});Features
| Feature | Description |
|---|---|
| Auto-Discovery | Scans AWS for Lambda functions tagged for MCP exposure |
| Step Functions | Trigger and poll state machines as long-running MCP actions |
| GroupedToolBuilders | Each Lambda becomes a typed MCP tool with Zod validation |
| IAM Integration | Uses your existing AWS credentials and IAM roles |
| Multi-Region | Discover across multiple regions simultaneously |
Step Functions
import { discoverStepFunctions } from '@vurb/aws';
await discoverStepFunctions(registry, {
region: 'us-east-1',
prefix: 'mcp-',
});Installation
npm install @vurb/aws @aws-sdk/client-lambdaPeer Dependencies
| Package | Version |
|---|---|
vurb |
^2.0.0 |
@aws-sdk/client-lambda |
^3.0.0 (optional) |
@aws-sdk/client-sfn |
^3.0.0 (optional) |
Requirements
- Node.js ≥ 18.0.0
- Vurb.ts ≥ 2.0.0 (peer dependency)
- AWS credentials configured (env vars, IAM role, or AWS config file)