>run_playbook { "playbook": "/path/to/your/playbook.yml", "inventory": "/path/to/inventory.ini", "extraVars": { "var1": "value1", "var2": "value2" }, "tags": "setup,configure", "limit": "webservers" } ``` ### 2. List Inventory ``` sysoperator list_inventory { "inventory": "/path/to/inventory.ini" } ``` ### 3. Check Playbook Syntax ``` sysoperator check_syntax { "playbook": "/path/to/your/playbook.yml" } ``` ### 4. List Tasks in a Playbook ``` sysoperator list_tasks { "playbook": "/path/to/your/playbook.yml" } ``` ### 5. Access Default Inventory Resource ``` sysoperator sysoperator://inventory/default ``` ### 6. AWS S3 Operations ``` sysoperator aws_s3 { "action": "list_buckets", "region": "us-east-1" } ``` ### 7. Terraform Init and Plan ``` sysoperator terraform { "action": "init", "workingDir": "/path/to/terraform/project" } sysoperator terraform { "action": "plan", "workingDir": "/path/to/terraform/project", "vars": { "instance_type": "t2.micro", "region": "us-west-2" } } ``` ### 8. Terraform Apply ``` sysoperator terraform { "action": "apply", "workingDir": "/path/to/terraform/project", "autoApprove": true, "vars": { "instance_type": "t2.micro", "region": "us-west-2" } } ``` ### 9. Terraform with LocalStack (tflocal) ``` sysoperator terraform { "action": "apply", "workingDir": "/path/to/terraform/project", "useLocalstack": true, "autoApprove": true, "vars": { "instance_type": "t2.micro", "region": "us-west-2" } } ``` ## LocalStack Integration This project includes integration with LocalStack for testing AWS operations locally without real AWS credentials. The LocalStack integration allows you to: 1. Test Ansible playbooks 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 ### Using LocalStack See the [LocalStack README](localstack/README.md) for detailed instructions on using the LocalStack integration. Quick start: ```bash # Install LocalStack and awslocal CLI pip install localstack awscli-local # Start LocalStack localstack start # Run the sample playbook node localstack/run_sample_playbook.mjs ``` ## Development ### Project Structure ``` mcp-sysoperator/ ├── src/ │ ├── index.ts # Main entry point │ └── ansible-mcp-server/ # Will be renamed in filesystem in future updates │ ├── index.ts # MCP SysOperator server implementation │ ├── common/ # Common utilities and types │ │ ├── errors.ts # Error definitions │ │ ├── types.ts # Type and schema definitions │ │ ├── utils.ts # Utility functions │ │ └── version.ts # Version information │ └── operations/ # Operation handlers │ ├── ad_hoc.ts # Ansible ad-hoc commands │ ├

#localstack

MCP SysOperator