使用说明

项目简介

AWS MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供与 AWS 服务交互的能力。它通过工具化的方式，让 LLM 可以安全、可控地访问和操作 AWS 资源，以及本地文件系统。

主要功能点

AWS SDK 工具: 提供多种预定义的工具，方便 LLM 访问常见的 AWS 服务，例如：
- S3: 列出存储桶、列出存储桶中的对象。
- EC2: 描述实例、列出安全组、列出 VPC。
- RDS: 描述数据库实例。
- Cost Explorer: 获取成本和使用报告、获取资源特定成本分析。
- CloudWatch: 获取指标统计数据。
本地文件系统工具: 允许 LLM 访问本地文件系统，例如：
- 列出本地文件夹。
- 读取代码文件内容 (支持多种代码文件扩展名)。
通用 AWS SDK 封装工具: 提供 'aws_sdk_wrapper' 工具，允许调用任何 AWS SDK 支持的服务和操作，极大地扩展了服务器的功能。

安装步骤

安装 Python: 确保已安装 Python 3.12 或更高版本。
配置 AWS 凭证: 配置 AWS 访问密钥和密钥，通常通过 '~/.aws/credentials' 文件或环境变量进行配置。
安装 'uv': 按照仓库 README.md 中的指引安装 'uv' 包管理器。
使用 'uv' 安装 Python: 使用 'uv' 安装 Python 3.10 或更新版本，例如 'uv python install 3.10'。
克隆仓库: 将 'aws-sa-tools-mcp-server' 仓库克隆到本地。

服务器配置

对于 MCP 客户端（如 Claude Desktop），需要在客户端的配置文件中指定 MCP 服务器的启动命令和参数。以下是一个示例配置，请将 '/path/to/aws-mcp-server' 替换为你的 'aws-mcp-server' 仓库的实际路径。

{
    "mcpServers": {
        "aws-mcp-server": {
            "command": "uvx",
            "args": [
                "--directory",
                "/path/to/aws-mcp-server",
                "."
            ]
        }
    }
}

如果在 WSL (Windows Subsystem for Linux) 环境中使用，配置可能需要调整为：

{
    "mcpServers": {
        "aws-mcp-server": {
            "command": "wsl.exe",
            "args": [
                "bash",
                "-c",
                "uvx --directory /path/to/aws-mcp-server ."
            ]
        }
    }
}

基本使用方法

启动 MCP 服务器: 在 'aws-mcp-server' 仓库目录下，打开终端，根据需要选择传输协议 (stdio 或 sse) 和端口，运行 'python aws_mcp_server/server.py' 命令启动服务器。
- 使用 stdio 传输 (默认): 'python aws_mcp_server/server.py'
- 使用 SSE 传输并指定端口 8080: 'python aws_mcp_server/server.py --sse --port 8080'
配置 MCP 客户端: 在 MCP 客户端中（例如 Claude Desktop），根据上述 服务器配置 部分的说明，配置 'aws-mcp-server' 的连接信息。
在 LLM 中使用工具: 在与 LLM 的对话中，可以使用自然语言指令来调用服务器提供的工具。例如，你可以指示 LLM "列出我的 S3 存储桶" 或 "查询 EC2 实例信息"。服务器会将请求转换为对 AWS 服务的调用，并将结果返回给 LLM。

关键词

使用说明

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息