Skip to content

README.md

Latest commit

 

History

History
104 lines (71 loc) · 3.23 KB

README.md

File metadata and controls

104 lines (71 loc) · 3.23 KB

LocalStack Integration for MCP SysOperator Server

This directory contains scripts and utilities for integrating the MCP SysOperator server with LocalStack, allowing you to test AWS operations locally without real AWS credentials.

Overview

LocalStack is a cloud service emulator that runs in a single container on your laptop or in your CI environment. It allows you to run AWS applications or Lambda functions without connecting to a remote AWS cloud.

This integration enables you to:

  1. Test IaC that use AWS services locally
  2. Develop and test AWS operations without incurring AWS costs
  3. Run tests without requiring real AWS credentials
  4. Validate your infrastructure code before deploying to real AWS

Prerequisites

  • Node.js 18 or higher
  • npm or yarn
  • Ansible installed and in PATH
  • LocalStack installed and running
  • awslocal CLI installed

Installing LocalStack

# Install LocalStack
pip install localstack

# Install awslocal CLI
pip install awscli-local

# Start LocalStack
localstack start

Files

  • localstack_test.mjs: Basic test script for running Ansible playbooks with LocalStack
  • localstack_aws_operations.mjs: Utility library for AWS operations using LocalStack
  • test_mcp_with_localstack.mjs: Comprehensive test script for MCP Ansible server with LocalStack
  • mcp_localstack_patch.js: Documentation for modifying the MCP Ansible server to use LocalStack

Usage

Running the Test Scripts

# Run the basic test script
node localstack/localstack_test.mjs

# Run the AWS operations utility
node localstack/localstack_aws_operations.mjs

# Run the comprehensive test script
node localstack/test_mcp_with_localstack.mjs

Modifying the MCP SysOperator Server for LocalStack

To modify the MCP Ansible server to use LocalStack instead of real AWS:

  1. Edit src/ansible-mcp-server/common/utils.ts:

    • Replace aws --version with awslocal --version in checkAwsCliInstalled()
    • Replace aws sts get-caller-identity with awslocal sts get-caller-identity in checkAwsCredentials()

  2. Rebuild the server:

    npm run build

Creating Ansible Playbooks for LocalStack

When creating Ansible playbooks for LocalStack, use shell commands with awslocal instead of AWS modules:

- name: List S3 buckets
  shell: awslocal s3 ls
  register: s3_buckets

- name: Display buckets
  debug:
    var: s3_buckets.stdout_lines

Supported AWS Services

The following AWS services have been tested with this integration:

  • S3: Create buckets, upload files, list objects
  • CloudFormation: Create stacks, deploy templates
  • EC2: List instances (creating instances requires AMI setup in LocalStack)

Implementation Strategy

For a complete integration of the MCP SysOperator server with LocalStack:

  1. Create a fork of the MCP SysOperator server repository
  2. Modify the utils.ts file to use awslocal instead of aws
  3. Modify the aws.ts file to use shell commands with awslocal instead of AWS modules
  4. Add a flag or environment variable to toggle between real AWS and LocalStack
  5. Rebuild the server and test with LocalStack

This approach allows you to use the MCP SysOperator server with LocalStack for testing without affecting the ability to use it with real AWS when needed.