用途
mcp-server-s3 是一个用于 AWS S3 的 MCP 服务器，旨在让用户通过 AI 助手管理 S3 存储桶和对象，而不必在命令行中记忆 aws s3 ls、aws s3 cp、预签名 URL 语法和各种标志参数。
主要能力
- 列出存储桶
- 浏览对象
- 读取/上传文本对象
- 下载内容
- 删除键
- 生成预签名 URL
- 存储桶检查
使用方式
该服务器可与 Claude Desktop、Cursor、VS Code Copilot 以及任何 MCP 客户端配合使用，并复用现有的 AWS 凭证。
添加至 .cursor/mcp.json。
添加至 claude_desktop_config.json（macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json）。
配置 MCP 服务器运行 npx mcp-server-s3，并在环境中提供 AWS_REGION、AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
服务器使用标准 AWS 凭证链：
- 环境变量：AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION
- 共享凭证文件：~/.aws/credentials
- IAM 角色：在 EC2、ECS、Lambda 或类似环境中运行时
设置 AWS_REGION（默认为 us-east-1），并确保凭证具有必要的 S3 权限：s3:ListBuckets、s3:ListBucket、s3:GetObject、s3:PutObject、s3:DeleteObject、s3:HeadBucket。
该仓库是一个 Agent Plugins 1.0.0 包：plugin.json、可移植的 mcp.json 和 skills/ 与 MCP 服务器一同发布。
对于 Cursor，克隆仓库并将其复制或符号链接到 ~/.cursor/plugins/local/mcp-server-s3，然后重新加载窗口。Skills 和 MCP 会显示在 Customize > Plugins 下。
适用场景与示例提示
- "List all my S3 buckets"
- "Show me the files in my-bucket/uploads/"
- "Download the config.json from my-bucket"
- "Upload this content to my-bucket/notes.txt"
- "Generate a presigned URL for this file that expires in 1 hour"
限制
- Agent Plugins v1 不包含 OAuth 或 AWS SSO 接线。需在 MCP 客户端主机中通过环境变量或 ~/.aws/credentials 设置 AWS_REGION 和凭证。
- 不提供一键安装，因为密钥保留在环境变量中。
- AWS 密钥无法嵌入可移植的安装链接中，需使用 Quick Start 下的 JSON。
常见问题
- 什么是 mcp-server-s3？一个用于 S3 的 MCP 服务器：列出存储桶和对象、读取/上传文本对象、删除键、预签名 URL 以及存储桶检查。
- 认证如何工作？标准 AWS 凭证链：环境变量、共享凭证文件，或运行 MCP 服务器机器上的 IAM 角色。
- MCP 配置中应设置哪些环境变量？至少 AWS_REGION。除非依赖 ~/.aws/credentials 或角色，通常还需 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
- 可以在 Cursor 中作为 Agent Plugin 安装吗？可以，通过 ~/.cursor/plugins/local/mcp-server-s3。确保 Cursor 进程能读取与 CLI 相同的 AWS 凭证。
- 为什么没有一键 Cursor 按钮？AWS 密钥无法嵌入可移植的安装链接中。请使用 Quick Start 下的 JSON。
MIT © 2026 Ofer Shapira
