项目简介

AWS EC2实例 MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端服务,旨在为LLM应用提供AWS EC2实例信息的上下文数据。它通过 MCP 协议与客户端通信,提供查询指定AWS区域内正在运行的EC2实例的工具。

主要功能点

  • 获取EC2实例列表: 提供 'get-aws-instances' 工具,允许LLM客户端查询指定AWS区域的EC2运行实例。
  • 实例详细信息: 返回实例ID、实例类型、公有IP、私有IP和实例状态等关键信息。
  • 基于MCP协议: 使用标准的 MCP 协议与客户端进行通信。
  • Stdio传输: 通过标准输入/输出流 (Stdio) 与客户端建立连接。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/codewithdpk/aws-mcp-server.git
    cd aws-mcp-server
  2. 安装依赖:
    npm install
  3. 配置 AWS 凭证: 在项目根目录下创建 '.env' 文件,并填入您的AWS Access Key ID 和 Secret Access Key:
    AWS_ACCESS_KEY_ID=您的AWS_ACCESS_KEY_ID
    AWS_ACCESS_SECRET_KEY=您的AWS_ACCESS_SECRET_KEY
  4. 构建服务器:
    npm run build

服务器配置

要将此 MCP 服务器配置到 MCP 客户端(例如 Claude for Desktop),您需要提供以下配置信息。请注意将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/aws-mcp-server' 替换为您的 'aws-mcp-server' 仓库的绝对路径。

{
    "mcpServers": {
        "aws-ec2-instances": {  // 服务器名称,您可以自定义
            "command": "node",  // 启动命令,这里使用 Node.js 运行
            "args": [
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/aws-mcp-server/build/index.js" // 服务器入口文件路径
            ]
        }
    }
}

基本使用方法

  1. 启动 MCP 服务器。在仓库根目录下运行:
    npm run start
    或者直接运行构建后的文件:
    node build/index.js
  2. 在 MCP 客户端中配置并连接到此服务器。
  3. 使用客户端提供的界面或命令,调用 'get-aws-instances' 工具,并提供 AWS 区域参数(例如 'ap-southeast-2')。
  4. 服务器将返回指定区域的 EC2 运行实例列表。

工具调用示例 (在 MCP 客户端中):

server.tool("get-aws-instances", { region: "ap-southeast-2" })

信息

分类

开发者工具