使用说明
🚀 MCP-AWS:用于 AWS EC2 管理的 AI 代理
欢迎来到 MCP-AWS,一个简单而强大的AI驱动应用程序,利用OpenAI代理和MCP服务器来管理AWS EC2实例。此应用程序允许您在终端中使用自然语言命令配置和终止EC2实例。 🖥️✨
🎥 演示视频
观看演示视频,了解MCP-AWS的实际操作! 🚀
🌟 特性
- 配置EC2实例:只需告诉AI代理创建一个EC2实例,它将处理其余部分,并为您提供实例ID。🛠️
- 终止EC2实例:提供实例ID,代理将为您终止实例。 ❌
- MCP服务器集成:探索如何创建自定义MCP服务器并将其与OpenAI代理SDK集成。 🧩
🛠️ MCP服务器中的工具
MCP服务器是一个具有两个工具的自定义服务器:
initiate_aws_ec2_instance:创建AWS EC2实例。terminate_aws_ec2_instance:根据AWS EC2实例的ID终止该实例。
🚀 入门指南
先决条件
- Python 3.12+ (用于本地设置)或 码头工人 (用于集装箱设置)
- AWS IAM角色:创建具有管理EC2实例所需权限的IAM角色。
- 环境变量:准备
.env包含以下变量的文件:AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYAWS_DEFAULT_REGIONOPENAI_API_KEYAMI_IDINSTANCE_TYPEKEY_NAMESECURITY_GROUP_IDSAWS_REGION
🏃♂️ 运行应用程序
- 克隆存储库:
git clone https://github.com/anirban1592/mcp-server-aws.git cd mcp-aws - 创建
.env文件如必备项所示
选项1:Docker设置(推荐)
- 构建Docker镜像:
docker image build -t my-mcp . - 运行容器:
docker container run -it my-mcp
选项2:本地设置
-
创建并激活虚拟环境:
pip install uv uv venv .venv # Windows .venv\Scripts\activate # Unix/MacOS source .venv/bin/activate -
运行应用程序:
cd openai-agent/ uv run agent.py
💬 使用AI代理
-
要创建EC2实例,请执行以下操作:
Enter your command: Create an EC2 instance -
要终止EC2实例,请执行以下操作:
Enter your command: Terminate EC2 instance with ID <instance-id>
⚠️ 警告语
- IAM角色和凭据:请自担风险创建AWS IAM角色和凭据。确保您遵循AWS的安全最佳实践。
- 计费和安全:此应用程序是概念验证(POC),仅用于学习目的。我们不对任何计费问题或安全事件负责。
📚 学习内容
该项目展示了:
- 如何将MCP服务器与OpenAI代理SDK集成
- 如何为AWS资源管理构建一个简单的AI驱动应用程序
享受探索AI和MCP服务器的力量! 🌟
