Infra Automation MCP

基础设施自动化MCP

适用于Okta、AWS和Terraform的AI驱动CI/CD

   

⚡ 快速开始

选项A：观看视频

🎥 点击此处观看5分钟演示

选项B：自己试试

1. 克隆和安装

   git clone https://github.com/metalfa/infra-automation-mcp.git
   cd infra-automation-mcp
   python -m venv venv && source venv/bin/activate
   pip install -e .

1. 配置 （参见 安装)

1. 问克劳德：

   Create a new user john.doe@example.com, generate Terraform 
   for an EC2 instance, and show me the access review report.

1. 看魔术发生 ✨

将基础设施管理从CLI命令转换为自然语言，而不牺牲安全性、可审计性或DevOps最佳实践。

这个项目是 生产级模型上下文协议（MCP）服务器 使人工智能助手（Claude）能够通过以下方式管理企业基础设施 自然语言，同时执行 GitOps、CI/CD和人工审批门.

用户描述的不是记忆CLIs、导航云控制台或手写Terraform *意图* --系统安全地将该意图转化为 经过审查、可审计的基础设施变更.

______________________________________________________________________

📋 关于本项目

该项目是ActiveCampaign系统工程师职位的带回家练习。

挑战：

*“设计一个CI/CD管道来管理Okta实例和EC2或ECS/EKS服务器集。”*

我的方法：

我没有提交静态图表或文档，而是构建了一个 功能齐全的生产级系统 这表明：

我为何超越：

我认为展示DevOps专业知识的最佳方式是 建造一些真实的东西这个项目不仅展示了 *什么* CI/CD管道应该可以，但是 *如何* 现代人工智能增强的基础设施自动化可以改变团队的工作方式，将45分钟的手动过程减少到30秒的对话。

______________________________________________________________________

🎯 为什么存在

传统基础设施工作的问题

简单的入职流程通常需要：

# Create Okta user
okta users create --firstName Bruce --lastName Lee --email bruce@demoac.com

# Find group
okta groups list | grep "Security-Engineering"

# Add user to group
okta groups members add 00g123... 00u987...

# Write Terraform
vim terraform/users.tf

# Create PR
git checkout -b add-user-bruce
git add .
git commit -m "Add user Bruce Lee"
git push origin add-user-bruce
gh pr create

# Wait, review, apply
terraform apply

______________________________________________________________________

此MCP的结果相同

你说：

1. Create an Okta user for "bruce.lee@demoac.com" (Bruce Lee, Security Engineer), 
   create a Security-Engineering group, add him to it, and send him a Slack welcome message

2. Generate Terraform for a free-tier EC2 instance called "bruce-lee-devbox"

3. Generate IAM configuration that maps to Okta for SSO

4. Create a GitHub PR with these changes and send a Slack message for approval

克劳德回应道：

______________________________________________________________________

🖌️ 核心设计原则

该系统 增强 DevOps工作流——它不会绕过它们。

______________________________________________________________________

🚀 关键能力

身份管理（Okta）

协作和通知（Slack）

AWS基础架构

地形生成

CI/CD 和 GitOps

合规与安全

______________________________________________________________________

🏗️ 架构概述

flowchart TB
    subgraph Input["🎯 INPUT"]
        User["👤 User"]
    end

    subgraph Intelligence["🤖 AI LAYER"]
        Claude["Claude Desktop"]
        MCP["MCP Server"]
    end

    subgraph OktaOps["🔐 OKTA OPERATIONS"]
        CreateUser["Create User"]
        CreateGroup["Create Group"]
        AssignGroup["Assign to Group"]
    end

    subgraph GitOps["📦 GITOPS WORKFLOW"]
        Repo["GitHub Repo"]
        PR["Pull Request"]
        Actions["GitHub Actions"]
        Projects["GitHub Projects"]
    end

    subgraph Infra["☁️ INFRASTRUCTURE"]
        Okta["Okta"]
        AWS["AWS"]
    end

    subgraph Notify["📢 NOTIFICATIONS"]
        Slack["Slack"]
    end

    User -->|Natural Language| Claude
    Claude -->|MCP Protocol| MCP
    MCP -->|Create User| CreateUser
    MCP -->|Create Group| CreateGroup
    CreateUser --> AssignGroup
    CreateGroup --> AssignGroup
    AssignGroup -->|Sync to| Okta
    MCP -->|Generate IaC| Repo
    MCP -->|Alert Team| Slack
    Repo -->|Opens| PR
    PR -->|Triggers| Actions
    PR -->|Creates Card| Projects
    Actions -->|Plan Output| PR
    Actions -->|On Merge| AWS
    Actions -->|Update Status| Projects
    Actions -->|Notify| Slack
    Okta -.->|SSO Federation| AWS

______________________________________________________________________

🔑 主要财产

______________________________________________________________________

🔐 安全模型

______________________________________________________________________

🛠️ CI/CD管道（GitHub操作）

关于Pull请求

┌─────────────────┐
│ terraform fmt   │ → Code formatting check
├─────────────────┤
│ terraform init  │ → Initialize providers
├─────────────────┤
│ terraform plan  │ → Preview changes
├─────────────────┤
│ Post to PR      │ → Plan visible to reviewers
├─────────────────┤
│ Update Project  │ → Moves card to "Backlog"
└─────────────────┘

关于合并到主

┌─────────────────┐
│ terraform apply │ → Create resources
├─────────────────┤
│ Wait 3 minutes  │ → Demo observation window
├─────────────────┤
│ terraform destroy│ → Auto-cleanup (cost control)
├─────────────────┤
│ Slack notify    │ → Confirm completion
├─────────────────┤
│ Update Project  │ → Moves card to "Done"
└─────────────────┘

______________________________________________________________________

安装

先决条件

快速开始

# Clone the repository
git clone https://github.com/metalfa/infra-automation-mcp.git
cd infra-automation-mcp

# Create virtual environment
python -m venv venv

# Activate (Windows)
.\venv\Scripts\Activate.ps1

# Activate (Mac/Linux)
source venv/bin/activate

# Install package
pip install -e .

配置

1. 创建环境文件：

   cp .env.example .env

1. 在中配置凭据 .env:

   # Okta
   OKTA_BASE_URL=https://your-org.okta.com
   OKTA_API_TOKEN=your-okta-token
   
   # AWS
   AWS_REGION=us-east-1
   AWS_ACCESS_KEY_ID=your-access-key
   AWS_SECRET_ACCESS_KEY=your-secret-key
   
   # GitHub
   GITHUB_TOKEN=your-github-pat
   GITHUB_REPO=your-username/infra-automation-mcp
   
   # Slack
   SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx

1. 在Claude Desktop中注册MCP服务器并更新Claude_Desktop_config文件，重新启动，您就准备好了。

______________________________________________________________________

💬 示例用例

👤 员工入职

Create user maria.garcia@company.com (Maria Garcia, DevOps Engineer),
add her to the devops-team group, generate Terraform for her IAM access,
create a PR, and send a Slack welcome message.

🖥️ 开发环境

Provision a free-tier EC2 instance called "dev-sandbox" with SSH access,
generate the Terraform code, and create a PR for review.

🔒 SOC2访问审查

Generate a comprehensive access review report showing all Okta users,
their group memberships, inactive accounts, and security recommendations.

🚀 完整的基础架构工作流程

Set up infrastructure for the new Data Science team:
1. Create Okta group "data-science"
2. Create user alex.kim@company.com
3. Generate EC2 and IAM Terraform
4. Create PR and notify approvers via Slack

所有这些都是通过对话驱动的——所有这些都通过GitOps强制执行。

______________________________________________________________________

📊 业务影响

______________________________________________________________________

🗺️ 路线图

• \[x\] Okta用户和组管理
• \[x\] AWS EC2和IAM配置
• \[x\] 地形代码生成
• \[x\] GitHub公关自动化
• \[x\] 松弛通知
• \[x\] 自动销毁以控制成本
• \[\]Azure AD/Entra ID集成
• \[\]Intune和Kandji MDM支持
• \[\]Kubernetes清单生成
• \[\]政策即代码（OPA/哨兵）
• \[\]成本估算（基础设施成本）
• \[\]多云支持（GCP、Azure）

______________________________________________________________________

🎓 为何这很重要

DevOps的未来是对话式的 --工程师专注于 *什么* 需要发生，而不是 *如何* 在数十个工具上执行它。

______________________________________________________________________

🎯 这如何应对挑战

💡 是什么让这个解决方案与众不同

1. 这是真的 --不是图表，而是可以克隆和运行的工作代码
2. 这很有创新性 --AI驱动的界面，同时保持GitOps规范
3. 这很实用 --解决实际痛点（入职、配置、合规）
4. 很安全 --人工审批门、自动销毁、最低权限默认值
5. 它是可扩展的 --模块化设计，适用于Entra ID、Intune、Kubernetes、多云

______________________________________________________________________

👤 作者

法伊卡尔·本·萨西\ IT系统工程师

](https://github.com/metalfa)  

______________________________________________________________________

Built to demonstrate an AI-driven infrastructure automation for ActiveCampaign — Systems Engineer technical assessment

"The best way to predict the future is to build it — and the future of DevOps is conversational."