{"id":27928547,"url":"https://github.com/tarnover/mcp-sysoperator","last_synced_at":"2026-04-02T01:34:04.131Z","repository":{"id":291522995,"uuid":"977877319","full_name":"tarnover/mcp-sysoperator","owner":"tarnover","description":"MCP for Ansible, Terraform, LocalStack, and other IaC tools. Create and iterate IaC","archived":false,"fork":false,"pushed_at":"2026-02-18T21:50:26.000Z","size":212,"stargazers_count":24,"open_issues_count":4,"forks_count":10,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-19T03:19:41.626Z","etag":null,"topics":["ansible","claude","cline","localstack","mcp","mcp-server","mcp-servers","terraform"],"latest_commit_sha":null,"homepage":"https://tarnover.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tarnover.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-05T05:42:38.000Z","updated_at":"2026-02-18T03:42:32.000Z","dependencies_parsed_at":"2025-05-23T00:35:17.560Z","dependency_job_id":"a16d2c3c-4252-4562-a7ed-7c74fa91ffe6","html_url":"https://github.com/tarnover/mcp-sysoperator","commit_stats":null,"previous_names":["tarnover/mcp-ansible","tarnover/mcp-sysoperator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tarnover/mcp-sysoperator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarnover%2Fmcp-sysoperator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarnover%2Fmcp-sysoperator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarnover%2Fmcp-sysoperator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarnover%2Fmcp-sysoperator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tarnover","download_url":"https://codeload.github.com/tarnover/mcp-sysoperator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarnover%2Fmcp-sysoperator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293938,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T01:05:07.454Z","status":"ssl_error","status_checked_at":"2026-04-02T00:56:46.496Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","claude","cline","localstack","mcp","mcp-server","mcp-servers","terraform"],"created_at":"2025-05-07T02:40:40.565Z","updated_at":"2026-04-02T01:34:04.126Z","avatar_url":"https://github.com/tarnover.png","language":"TypeScript","funding_links":[],"categories":["Cloud \u0026 Devops Mcp Servers","Developer Tools"],"sub_categories":["How to Submit"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://www.tarnover.com/assets/images/logo.png\" alt=\"SysOperator\" width=\"500\"\u003e\n\u003c/p\u003e\n\n# MCP SysOperator\n A Model Context Protocol (MCP) server for Infrastructure as Code operations. This server allows AI assistants to interact with Ansible and Terraform, execute playbooks and Terraform plans, manage cloud resources, and perform other infrastructure operations directly.  \n (Project previously known as _mcp-ansible_) \n\n## Demo Projects\n__All code in demos generated using Claude 3.7 Sonnet (via OpenRouter), Cline, and SysOperator__\n\n- **[AWS LAMP Stack](demos/aws-lamp-stack)** - All Ansible code to deploy example LAMP stack in AWS\n- **[AWS Terraform LAMP](demos/aws-terraform-lamp)** - Terraform and Ansible code to reply a LAMP stack\n\n\n## Features\n\n- **Run Ansible Playbooks**: Execute Ansible playbooks with support for parameters like inventory, extra vars, tags, and limits\n- **List Inventory**: View hosts and groups from an Ansible inventory file\n- **Check Syntax**: Validate Ansible playbook syntax without execution\n- **List Tasks**: Preview tasks that would be executed by a playbook\n- **Access Default Inventory**: Access the default Ansible inventory file via resource API\n- **AWS Integration**: Manage AWS resources (EC2, S3, VPC, CloudFormation, etc.)\n- **Terraform Support**: Execute Terraform commands (init, plan, apply, destroy, output, etc.)\n- **tflocal Integration**: Test Terraform configurations with LocalStack for local cloud development\n- **LocalStack Support**: Test AWS operations locally using LocalStack without real AWS credentials\n\n## Requirements\n\n- Node.js 18 or higher\n- npm or yarn\n- Ansible installed and in PATH\n- @modelcontextprotocol/sdk (installed automatically)\n- For AWS operations: AWS CLI and valid credentials\n- For LocalStack: LocalStack installed and running, awslocal CLI\n\n## Installation\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/tarnover/mcp-sysoperator.git\ncd mcp-sysoperator\n```\n\n### 2. Install dependencies\n\n```bash\nnpm install\n```\n\n### 3. Build the server\n\n```bash\nnpm run build\n```\n\n### 4. Configure MCP settings\n\nAdd the Ansible MCP server to your MCP settings configuration file.\n\nFor VSCode with Claude extension:\n- Edit the file at `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`\n\nFor Claude Desktop app:\n- macOS: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: Edit `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Linux: Edit `~/.config/Claude/claude_desktop_config.json`\n\nAdd the following to the `mcpServers` section:\n\n```json\n{\n  \"mcpServers\": {\n    \"sysoperator\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-sysoperator/build/index.js\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\nMake sure to replace `/absolute/path/to/mcp-sysoperator` with the actual path to your installation.\n\n## Usage Examples\n\nOnce installed and configured, the MCP server provides the following tools to the AI assistant:\n\n### 1. Run a Playbook\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003erun_playbook\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"playbook\": \"/path/to/your/playbook.yml\",\n  \"inventory\": \"/path/to/inventory.ini\",\n  \"extraVars\": {\n    \"var1\": \"value1\",\n    \"var2\": \"value2\"\n  },\n  \"tags\": \"setup,configure\",\n  \"limit\": \"webservers\"\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n### 2. List Inventory\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003elist_inventory\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"inventory\": \"/path/to/inventory.ini\"\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n### 3. Check Playbook Syntax\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003echeck_syntax\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"playbook\": \"/path/to/your/playbook.yml\"\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n### 4. List Tasks in a Playbook\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003elist_tasks\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"playbook\": \"/path/to/your/playbook.yml\"\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n### 5. Access Default Inventory Resource\n\n```\n\u003caccess_mcp_resource\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003curi\u003esysoperator://inventory/default\u003c/uri\u003e\n\u003c/access_mcp_resource\u003e\n```\n\n### 6. AWS S3 Operations\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003eaws_s3\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"action\": \"list_buckets\",\n  \"region\": \"us-east-1\"\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n### 7. Terraform Init and Plan\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003eterraform\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"action\": \"init\",\n  \"workingDir\": \"/path/to/terraform/project\"\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003eterraform\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"action\": \"plan\",\n  \"workingDir\": \"/path/to/terraform/project\",\n  \"vars\": {\n    \"instance_type\": \"t2.micro\",\n    \"region\": \"us-west-2\"\n  }\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n### 8. Terraform Apply\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003eterraform\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"action\": \"apply\",\n  \"workingDir\": \"/path/to/terraform/project\",\n  \"autoApprove\": true,\n  \"vars\": {\n    \"instance_type\": \"t2.micro\",\n    \"region\": \"us-west-2\"\n  }\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n### 9. Terraform with LocalStack (tflocal)\n\n```\n\u003cuse_mcp_tool\u003e\n\u003cserver_name\u003esysoperator\u003c/server_name\u003e\n\u003ctool_name\u003eterraform\u003c/tool_name\u003e\n\u003carguments\u003e\n{\n  \"action\": \"apply\",\n  \"workingDir\": \"/path/to/terraform/project\",\n  \"useLocalstack\": true,\n  \"autoApprove\": true,\n  \"vars\": {\n    \"instance_type\": \"t2.micro\",\n    \"region\": \"us-west-2\"\n  }\n}\n\u003c/arguments\u003e\n\u003c/use_mcp_tool\u003e\n```\n\n## LocalStack Integration\n\nThis project includes integration with LocalStack for testing AWS operations locally without real AWS credentials. The LocalStack integration allows you to:\n\n1. Test Ansible playbooks that use AWS services locally\n2. Develop and test AWS operations without incurring AWS costs\n3. Run tests without requiring real AWS credentials\n4. Validate your infrastructure code before deploying to real AWS\n\n### Using LocalStack\n\nSee the [LocalStack README](localstack/README.md) for detailed instructions on using the LocalStack integration.\n\nQuick start:\n\n```bash\n# Install LocalStack and awslocal CLI\npip install localstack awscli-local\n\n# Start LocalStack\nlocalstack start\n\n# Run the sample playbook\nnode localstack/run_sample_playbook.mjs\n```\n\n## Development\n\n### Project Structure\n\n```\nmcp-sysoperator/\n├── src/\n│   ├── index.ts                  # Main entry point\n│   └── ansible-mcp-server/       # Will be renamed in filesystem in future updates\n│       ├── index.ts              # MCP SysOperator server implementation\n│       ├── common/               # Common utilities and types\n│       │   ├── errors.ts         # Error definitions\n│       │   ├── types.ts          # Type and schema definitions\n│       │   ├── utils.ts          # Utility functions\n│       │   └── version.ts        # Version information\n│       └── operations/           # Operation handlers\n│           ├── ad_hoc.ts         # Ansible ad-hoc commands\n│           ├── aws.ts            # AWS operations\n│           ├── inventory.ts      # Ansible inventory operations\n│           ├── playbooks.ts      # Ansible playbook operations\n│           ├── terraform.ts      # Terraform operations\n│           └── vault.ts          # Ansible vault operations\n├── localstack/                   # LocalStack integration\n│   ├── README.md                 # LocalStack documentation\n│   ├── sample_playbook.yml       # Sample playbook for LocalStack\n│   ├── inventory.ini             # Sample inventory for LocalStack\n│   ├── run_sample_playbook.mjs   # Script to run sample playbook\n│   └── utils.localstack.ts       # Modified utils for LocalStack\n├── package.json                  # Project configuration and dependencies\n├── tsconfig.json                 # TypeScript configuration\n└── README.md                     # Documentation\n```\n\n### Adding New Features\n\nTo add new capabilities to the MCP server:\n\n1. Modify `src/ansible-mcp-server/index.ts` (future: `src/sysoperator/index.ts`)\n2. Add your new tool in the `setupToolHandlers` method\n3. Implement a handler function for your tool in the appropriate operations file\n4. Add the schema definition in `common/types.ts`\n5. Rebuild with `npm run build`\n\n### ⚠️ Disclaimer\n\nSysOperator is currently in active development and undergoing extensive testing. It is not recommended for use in production environments at this time. The software may experience breaking changes, incomplete features, or unexpected behavior.\n\n**Use at your own risk.**\n\n## License\n\nMIT License - See [LICENSE](LICENSE) for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarnover%2Fmcp-sysoperator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftarnover%2Fmcp-sysoperator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarnover%2Fmcp-sysoperator/lists"}