AWS S3 MCP 服务器

用于 AWS S3 操作的 MCP 服务器，通过预签名的 URL 提供对 S3 存储桶的安全访问。

工具

1. list_objects

   • 列出 S3 存储桶中的对象
   • 输入：
     • prefix（字符串，可选）：用于过滤对象键的前缀
   • 返回值：包含键、大小和最后修改日期的对象数组

2. get_object

   • 生成一个用于访问对象的预签名 URL
   • 输入：
     • key（字符串，必需）：要检索的对象键
     • expiry（数字，可选）：URL 的过期时间（以秒为单位，默认值：3600）
   • 返回值：包含预签名 URL 的 object_url

3. put_object

   • 生成一个用于上传对象的预签名 URL
   • 输入：
     • key（字符串，必需）：要上传的对象键
     • expiry（数字，可选）：URL 的过期时间（以秒为单位，默认值：3600）
   • 返回值：包含预签名 URL 的 upload_url

4. delete_object

   • 从存储桶中删除对象
   • 输入：
     • key（字符串，必需）：要删除的对象键
   • 返回值：表示删除状态的布尔值 success

配置

环境变量

该服务器需要以下环境变量：

• BUCKET_NAME：您的 S3 存储桶名称（必需）
• REGION：AWS 区域（默认值："ap-southeast-1"）

应使用标准的 AWS 凭证配置方法（环境变量、IAM 角色或 AWS 凭证文件）来配置 AWS 凭证。

在 Claude Desktop 中使用

在您的 claude_desktop_config.json 文件中添加以下内容：

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUCKET_NAME",
        "-e",
        "REGION",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "mcp/aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

使用 NPX 命令

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

构建

Docker 构建：

docker build -t mcp/aws-ow-s3-mcp-server .

开发

该服务器使用以下工具构建：

• Node.js
• TypeScript
• @modelcontextprotocol/sdk
• @aws-sdk/client-s3
• @aws-sdk/s3-request-presigner

许可证

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由地使用、修改和分发该软件，但需遵守 MIT 许可证中的条款和条件。如需更多详情，请参阅项目仓库中的 LICENSE 文件。