返回 MCP 目录
public公开dns本地运行

aws

AWS MCP Server是一个轻量级服务,通过Model Context Protocol(MCP)协议使AI助手能够执行AWS CLI命令,提供AWS CLI文档查询和命令执行功能。

article

README

🚀 AWS MCP 服务器模型

本项目的 AWS MCP 服务器模型具有显著的安全、可靠性等多方面优势,能为用户提供稳定、高效且便捷的使用体验,避免了传统安装和使用过程中的诸多问题。

🚀 快速开始

您可参考后续的版本管理部分创建新发行版本,CI/CD 管道会自动构建并发布带有适当版本标签的 Docker 镜像,从而开启使用本项目。

✨ 主要特性

安全优势

  • 隔离(主要缓解措施):Docker 容器提供了重要的文件系统和进程隔离。运行中的 AWS CLI 命令和管道 Unix 工具在一个受控的环境中执行。意外或误用命令对文件系统的破坏仅限于容器内部,从而保护宿主机。
  • 受控凭据访问:当挂载凭证时,使用 :ro 标志限制了容器修改 AWS 配置文件的能力。
  • 无本地安装:避免在您的主机系统上直接安装 AWS CLI 及其依赖项。
  • 干净环境:每次运行容器时,都会从一个已知的干净状态开始。

可靠性优势

  • 一致的配置:所有必需工具(AWS CLI、SSM 插件、jq)预先安装并正确配置。
  • 依赖管理:避免工具和依赖项之间的版本冲突。
  • 跨平台一致性:在不同的操作系统上以相同的方式工作。
  • 完整环境:包含所有必要的工具,用于命令管道、过滤和格式化。

其他优势

  • 多架构支持:适用于 Intel/AMD (x86_64) 和 ARM (Apple Silicon、AWS Graviton) 处理器。
  • 简单更新:通过一条拉取命令更新到新版本。
  • 无 Python 环境冲突:避免与其他系统上的 Python 应用程序发生冲突。
  • 版本固定:轻松将特定版本用于生产环境以确保稳定性。

📚 详细文档

版本管理

该项目使用 setuptools_scm 自动根据 Git 标签确定版本:

  • 发行版本:当存在 Git 标签(例如 1.2.3),版本将与标签完全一致。
  • 开发版本:对于无标签的提交,生成一个格式为 <last-tag>.post<commits-since-tag>+g<commit-hash>.d<date> 的开发版本(例如 1.2.3.post10+gb697684.d20250406)。

版本信息自动包含在:

  • 包版本信息
  • Docker 镜像标签
  • 持续集成构建

创建新版本

要创建新发行版本:

# 创建并推送上一条标签
git tag -a 1.2.3 -m "发布版本 1.2.3"
git push origin 1.2.3

CI/CD 管道会自动构建并发布带有适当版本标签的 Docker 镜像。

有关版本管理系统更详细的说明,请参阅 VERSION.md

📄 许可证

该项目根据 MIT 许可证授权 - 请查看 LICENSE 文件以获取详细信息。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端