使用说明

项目简介

AWS CLI MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许大型语言模型 (LLM) 客户端(如 Claude)通过 MCP 协议调用 AWS 命令行工具 (AWS CLI)。该服务器将 AWS CLI 的强大功能封装成易于 LLM 理解和调用的工具,使得用户可以通过自然语言指令,让 LLM 间接操作和管理 AWS 云资源。

主要功能点

  • 执行 AWS CLI 命令: 通过 'execute-aws-command' 工具,LLM 客户端可以执行任何有效的 AWS CLI 命令,从而实现对 AWS 服务的全面控制。
  • 获取 AWS 服务详情: 通过 'get-service-details' 工具,LLM 客户端可以查询特定 AWS 服务的描述和常用命令,帮助用户了解 AWS 服务的功能和使用方法。
  • 列出可用 AWS 服务: 通过 'aws-services://list' 资源,LLM 客户端可以获取支持的 AWS 服务列表,方便用户快速了解可操作的 AWS 服务范围。

总而言之,该服务器将复杂的 AWS CLI 命令抽象成易于 LLM 客户端调用的工具和资源,降低了 LLM 应用集成 AWS 云服务的门槛,实现了更智能化的云资源管理方式。

安装步骤

  1. 克隆仓库

    git clone https://github.com/IcyKallen/aws-cli-mcp-server
    cd aws-cli-mcp-server
  2. 安装依赖 确保你已安装 Node.js (v20 或更高版本) 和 npm 或 yarn。

    npm install
  3. 构建项目

    npm run build
  4. 配置 AWS CLI 确保你的 AWS CLI 已安装并配置了有效的 AWS 访问密钥和区域。

    aws configure

服务器配置

要将 AWS CLI MCP Server 集成到 MCP 客户端(例如 Claude Desktop),你需要配置客户端以连接到该服务器。以下是 'claude_desktop_config.json' 的配置示例:

{
  "mcpServers": {
    "aws-cli": {  // 服务器名称,可以自定义
      "command": "node", // 启动服务器的命令,这里使用 node.js 运行时
      "args": [
        "/path/to/aws-cli-mcp-server/dist/index.js" //  指向编译后的服务器入口文件 index.js 的路径,请替换为实际路径
      ]
    }
  }
}

请注意: 你需要将 '/path/to/aws-cli-mcp-server/dist/index.js' 替换为你本地 'aws-cli-mcp-server' 项目 'dist' 目录下 'index.js' 文件的绝对路径。

基本使用方法

配置完成后,在 MCP 客户端(如 Claude)中,你可以通过自然语言指令来调用 AWS CLI MCP Server 的功能。

示例用法:

  • 列出 S3 存储桶 在 Claude 中输入类似指令:'列出我的 S3 存储桶。' Claude 可能会调用 'execute-aws-command' 工具,并使用 's3 ls' 命令来执行。

  • 创建 S3 存储桶 在 Claude 中输入类似指令:'创建一个名为 "my-test-bucket" 的 S3 存储桶,区域为 us-west-2。' Claude 可能会调用 'execute-aws-command' 工具,并使用 's3 mb s3://my-test-bucket --region us-west-2' 命令来执行。

  • 查询 EC2 服务详情 在 Claude 中输入类似指令:'EC2 服务有哪些常用命令?' Claude 可能会调用 'get-service-details' 工具,并查询 'ec2' 服务的详情。

请根据你的具体需求,使用自然语言指令引导 LLM 客户端调用 AWS CLI MCP Server 提供的工具和资源,实现更智能化的 AWS 云资源管理。

信息

分类

开发者工具