Mcp Aws: Ai Agent For Aws Ec2 Management

🚀 MCP - AWS：AWS EC2 管理的 AI 代理

MCP - AWS 是一款简单且强大的 AI 驱动应用程序。它巧妙地结合了 OpenAI 代理和 MCP 服务器，让您能够轻松管理 AWS EC2 实例。您只需在终端使用自然语言命令，就能实现 EC2 实例的创建与终止，极大提升了操作的便捷性。🖥️✨

🚀 快速开始

先决条件

1. Python 3.12+（用于本地设置）或 Docker（用于容器化设置）
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 设置（推荐）

3. 构建 Docker 镜像：

docker image build -t my-mcp .

4. 运行容器：

docker container run -it my-mcp

选项 2：本地设置

3. 创建并激活虚拟环境：

pip install uv
uv venv .venv
# Windows
.venv\Scripts\activate
# Unix/MacOS
source .venv/bin/activate

4. 运行应用程序：

cd openai-agent/
uv run agent.py

💬 使用 AI 代理

1. 创建 EC2 实例：

输入您的命令：创建一个 EC2 实例

2. 终止 EC2 实例：

输入您的命令：终止实例 ID 为  的 EC2 实例

✨ 主要特性

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：可通过实例 ID 终止 AWS EC2 实例。

🎥 演示视频

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

⚠️ 重要提示

⚠️ 重要提示

请自行承担 AWS IAM 角色和凭证的风险，务必遵循 AWS 安全最佳实践。

此应用程序仅用于学习目的，我们不对任何计费问题或安全事件负责。

📚 详细文档

该项目展示了：

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

享受探索 AI 和 MCP 服务器的强大功能吧！🌟