AWS EC2管理AI代理

MCP-AWS是一款基于OpenAI代理和MCP服务器的AI驱动应用,通过自然语言命令在终端中管理AWS EC2实例的创建和终止。

  • by anirban1592
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 anirban1592/mcp-server-aws

使用说明

🚀 MCP-AWS:用于 AWS EC2 管理的 AI 代理

欢迎来到 MCP-AWS,一个简单而强大的AI驱动应用程序,利用OpenAI代理和MCP服务器来管理AWS EC2实例。此应用程序允许您在终端中使用自然语言命令配置和终止EC2实例。 🖥️✨


🎥 演示视频

观看演示视频,了解MCP-AWS的实际操作! 🚀


🌟 特性

  1. 配置EC2实例:只需告诉AI代理创建一个EC2实例,它将处理其余部分,并为您提供实例ID。🛠️
  2. 终止EC2实例:提供实例ID,代理将为您终止实例。 ❌
  3. MCP服务器集成:探索如何创建自定义MCP服务器并将其与OpenAI代理SDK集成。 🧩

🛠️ MCP服务器中的工具

MCP服务器是一个具有两个工具的自定义服务器:

  1. initiate_aws_ec2_instance:创建AWS EC2实例。
  2. terminate_aws_ec2_instance:根据AWS EC2实例的ID终止该实例。

🚀 入门指南

先决条件

  1. Python 3.12+ (用于本地设置)或 码头工人 (用于集装箱设置)
  2. AWS IAM角色:创建具有管理EC2实例所需权限的IAM角色。
  3. 环境变量:准备 .env 包含以下变量的文件:
    • AWS_ACCESS_KEY_ID
    • AWS_SECRET_ACCESS_KEY
    • AWS_DEFAULT_REGION
    • OPENAI_API_KEY
    • AMI_ID
    • INSTANCE_TYPE
    • KEY_NAME
    • SECURITY_GROUP_IDS
    • AWS_REGION

🏃‍♂️ 运行应用程序

  1. 克隆存储库:
    git clone https://github.com/anirban1592/mcp-server-aws.git
    cd mcp-aws
    
  2. 创建 .env 文件如必备项所示

选项1:Docker设置(推荐)

  1. 构建Docker镜像:
    docker image build -t my-mcp .
    
  2. 运行容器:
    docker container run -it my-mcp
    

选项2:本地设置

  1. 创建并激活虚拟环境:

    pip install uv
    uv venv .venv
    # Windows
    .venv\Scripts\activate
    # Unix/MacOS
    source .venv/bin/activate
    
  2. 运行应用程序:

    cd openai-agent/
    uv run agent.py
    

💬 使用AI代理

  1. 要创建EC2实例,请执行以下操作:

    Enter your command: Create an EC2 instance
    
  2. 要终止EC2实例,请执行以下操作:

    Enter your command: Terminate EC2 instance with ID <instance-id>
    

⚠️ 警告语

  • IAM角色和凭据:请自担风险创建AWS IAM角色和凭据。确保您遵循AWS的安全最佳实践。
  • 计费和安全:此应用程序是概念验证(POC),仅用于学习目的。我们不对任何计费问题或安全事件负责。

📚 学习内容

该项目展示了:

  1. 如何将MCP服务器与OpenAI代理SDK集成
  2. 如何为AWS资源管理构建一个简单的AI驱动应用程序

享受探索AI和MCP服务器的力量! 🌟