Mcp Server S3

mcp-server-s3

通过 AI 助手管理 AWS S3 存储桶和对象。浏览文件、上传和下载内容，并生成预签名 URL。

npx mcp-server-s3

兼容 Claude Desktop、Cursor、VS Code Copilot 及任何 MCP 客户端。使用你现有的 AWS 凭证（~/.aws/credentials 或环境变量）。

_{演示由 remotion-readme-kit 构建}

为什么

S3 是使用最广泛的云存储服务，但通过命令行管理它意味着要记住 aws s3 ls、aws s3 cp、预签名 URL 语法以及各种标志。Google 为 GCS 提供了官方 MCP，Cloudflare 为 R2 提供了官方 MCP，但 AWS S3 在 npm 上还没有成熟的独立 MCP 服务。使用这个服务，你可以让助手列出存储桶、下载配置文件、上传内容或生成临时分享链接。它使用标准的 AWS 凭证链，因此只要你的 CLI 能正常工作，它也能正常工作。

工具

工具	功能
list_buckets	列出 AWS 账户中的所有 S3 存储桶。
list_objects	列出存储桶中的对象，可选按前缀筛选。
get_object	下载对象并将其内容作为文本读取。
put_object	将文本内容上传到 S3 对象。
delete_object	从存储桶中删除对象。
presigned_url	为对象生成临时预签名 URL。
bucket_info	检查存储桶是否存在并获取基本信息。

快速开始

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "s3": {
      "command": "npx",
      "args": ["mcp-server-s3"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_ACCESS_KEY_ID": "your-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-secret-key"
      }
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "s3": {
      "command": "npx",
      "args": ["mcp-server-s3"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_ACCESS_KEY_ID": "your-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-secret-key"
      }
    }
  }
}

VS Code

配置 MCP 服务，使其使用环境变量 AWS_REGION、AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 运行 npx mcp-server-s3。

身份验证

服务使用标准的 AWS 凭证链：

1. 环境变量：AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION
2. 共享凭证文件：~/.aws/credentials
3. IAM 角色：在 EC2、ECS、Lambda 或类似环境中运行时使用

设置 AWS_REGION（默认为 us-east-1），并确保凭证具有所需的 S3 权限：s3:ListBuckets、s3:ListBucket、s3:GetObject、s3:PutObject、s3:DeleteObject、s3:HeadBucket。

Agent Plugins

此代码库是一个 Agent Plugins 1.0.0 软件包：plugin.json、可移植的 mcp.json 和 skills/ 与 MCP 服务一同提供。

对于 Cursor，克隆代码库并将其复制或建立符号链接到 ~/.cursor/plugins/local/mcp-server-s3，然后重新加载窗口。技能和 MCP 会显示在 Customize > Plugins 下。

Agent Plugins v1 不提供 OAuth 或 AWS SSO 集成。在 MCP 客户端宿主中通过环境变量或 ~/.aws/credentials 设置 AWS_REGION 和凭证。由于密钥保留在环境变量中，因此不提供一键安装。

常见问题

什么是 mcp-server-s3？

用于 S3 的 MCP 服务：列出存储桶和对象、读取／上传文本对象、删除键、生成预签名 URL，以及检查存储桶。

身份验证如何运作？

使用标准 AWS 凭证链：环境变量、共享凭证文件，或运行 MCP 服务的机器上的 IAM 角色。

应在 MCP 配置中设置哪些环境变量？

至少设置 AWS_REGION。通常还需要设置 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY，除非你使用 ~/.aws/credentials 或角色。

可以将它安装为 Cursor 中的 Agent Plugin 吗？

可以，通过 ~/.cursor/plugins/local/mcp-server-s3 安装。请确保 Cursor 进程能够读取与命令行相同的 AWS 凭证。

为什么没有一键式 Cursor 按钮？

AWS 密钥无法嵌入可移植的安装链接。请使用 Quick Start 下方的 JSON。

示例提示词

• “列出我所有的 S3 存储桶”
• “显示 my-bucket/uploads/ 中的文件”
• “从 my-bucket 下载 config.json”
• “将此内容上传到 my-bucket/notes.txt”
• “为此文件生成一个 1 小时后过期的预签名 URL”

开发

npm install
npm run typecheck
npm run build
npm test
npm run format
npm run lint

另请参阅

在我的作品集中查看更多 MCP 服务和开发者工具。

作者

---

_{README 使用 README Builder 构建}

许可证

MIT © 2026 Ofer Shapira