Aws S3 MCP 服务器 | PlugMCP
跳到正文 AWS S3 MCP Server
A Model Context Protocol (MCP) server that exposes AWS S3 operations through a secure, well-defined interface. This server provides tools for listing buckets and objects, and generating presigned URLs for safe data access.
Perfect for integrating S3 with Claude Desktop and other MCP clients!
Features
MCP server exposing AWS S3 tools: list buckets/objects, presigned GET/PUT, safe by default.
把任意工具接入任意智能体。面向非开发者的 MCP 服务器目录;网关承载流量,n8n 承载应用。
产品
目录
开发者
公司
List Buckets : Enumerate all S3 buckets in your AWS account
List Objects : Browse objects within a bucket with optional prefix filtering
Presigned GET URLs : Generate secure, temporary URLs for downloading objects
Presigned PUT URLs : Generate secure, temporary URLs for uploading objects (optional, requires ALLOW_WRITE flag)
Input Validation : All inputs are validated using Zod schemas
Logging : Structured logging with Pino
Safe by Default : Write operations are disabled unless explicitly enabled
Cross-Platform : Works on Windows, Mac, and Linux
🚀 Quick Start
Fastest Setup # 1. Install and build
npm install
npm run build
# 2. Configure AWS credentials
cp .env.example .env
# Edit .env with your AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION
# 3. Test connection
node examples/quick-test.js
4. Add to Your MCP Client For Claude Desktop - Edit claude_desktop_config.json:
{
"mcpServers": {
"aws-s3": {
"command": "node",
"args": ["/absolute/path/to/aws-s3-mcp-server/dist/index.js"]
}
}
}
For VS Code - Edit ~/.vscode/mcp.json:
{
"servers": {
"aws-s3": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/aws-s3-mcp-server/dist/index.js"]
}
}
}
Replace the path with your actual installation directory.
5. Test It
Claude Desktop: Restart → Ask "List my S3 buckets"
VS Code: Reload window → @aws-s3 list my buckets
Documentation
Setup Guide - Complete installation and configuration instructions
Usage Guide - How to use with Claude Desktop and examples
Examples - Sample scripts for download/upload operations
Installation npm install
npm run build
Configuration Create a .env file in the root directory (see .env.example):
# Required
AWS_ACCESS_KEY_ID=your_access_key_here
AWS_SECRET_ACCESS_KEY=your_secret_key_here
AWS_REGION=us-east-1
# Optional: Enable write operations (presign_put)
ALLOW_WRITE=false
# Optional: Set log level (default: info)
LOG_LEVEL=info
Usage The server uses stdio transport and communicates via standard input/output, making it suitable for integration with MCP clients like Claude Desktop.
Running Standalone
Common Operations "Show me all my S3 buckets"
List objects in a bucket:
"List all files in my-data-bucket"
"Give me a download link for report.pdf in my-docs-bucket"
Get upload link (if ALLOW_WRITE=true):
"Generate an upload URL for new-file.json in my-bucket"
Available Tools
1. s3_list_buckets List all S3 buckets in the AWS account.
[
{
"name": "my-bucket",
"creationDate": "2024-01-01T00:00:00.000Z"
}
]
2. s3_list_objects List objects in an S3 bucket with optional filtering.
bucket (required): The name of the S3 bucket
prefix (optional): Filter objects by prefix
maxKeys (optional): Maximum number of objects to return (1-1000)
{
"objects": [
{
"key": "path/to/file.txt",
"size": 1024,
"lastModified": "2024-01-01T00:00:00.000Z",
"etag": "\"abc123\""
}
],
"isTruncated": false,
"keyCount": 1
}
3. s3_presign_get Generate a presigned URL for downloading an object.
bucket (required): The name of the S3 bucket
key (required): The object key
expiresIn (optional): URL expiration time in seconds (default: 3600, max: 604800)
{
"url": "https://bucket.s3.amazonaws.com/key?X-Amz-Algorithm=...",
"expiresIn": 3600,
"bucket": "my-bucket",
"key": "path/to/file.txt"
}
4. s3_presign_put Generate a presigned URL for uploading an object (requires ALLOW_WRITE=true).
bucket (required): The name of the S3 bucket
key (required): The object key
expiresIn (optional): URL expiration time in seconds (default: 3600, max: 604800)
contentType (optional): Content type of the object
{
"url": "https://bucket.s3.amazonaws.com/key?X-Amz-Algorithm=...",
"expiresIn": 3600,
"bucket": "my-bucket",
"key": "path/to/file.txt",
"contentType": "application/json"
}
Development
Build
Watch Mode
Run Tests
Lint
Quick Connection Test node examples/quick-test.js
Troubleshooting
Server Not Responding in Claude
Check Claude Desktop logs: Help → Show Logs
Verify the server path in config is correct (use absolute path)
Test manually: node dist/index.js
Restart Claude Desktop
AWS Connection Issues Error: Missing credentials
Verify .env file exists in project root
Check no extra spaces in environment variables
Ensure file is named exactly .env (not .env.txt)
Verify IAM user has S3 permissions
Check the bucket exists in the specified region
Test credentials: node examples/quick-test.js
Error: Invalid Access Key
Verify AWS_ACCESS_KEY_ID is correct
Check AWS_SECRET_ACCESS_KEY matches
Ensure credentials haven't been rotated/deleted
Write Operations Not Working
Set ALLOW_WRITE=true in .env file
Restart the MCP server
Verify IAM user has PutObject permission
Performance Issues For buckets with millions of objects:
Use prefix filtering: "List files in my-bucket with prefix 'logs/2024/'"
Limit results: "Show first 100 files in my-bucket"
Organize files with prefixes (like folders)
Security Best Practices
Store credentials in .env file (never commit to git)
Use IAM users with minimal required permissions
Disable ALLOW_WRITE unless needed
Use short expiration times for presigned URLs
Rotate access keys regularly
Share presigned URLs publicly
Use root AWS account credentials
Commit .env file to version control
Grant broader permissions than necessary
Project Structure aws-s3-mcp-server/
├── dist/ # Compiled JavaScript (generated)
├── src/ # TypeScript source code
│ ├── index.ts # Main MCP server
│ └── index.test.ts # Unit tests
├── examples/ # Example scripts and usage
│ ├── quick-test.js # AWS connection test
│ ├── test-upload.ps1 # Upload example
│ └── test-download.ps1 # Download example
├── .env.example # Environment template
├── package.json # Dependencies
├── tsconfig.json # TypeScript config
├── README.md # This file
├── SETUP_GUIDE.md # Installation guide
└── USAGE_GUIDE.md # Usage examples
Security
AWS credentials are loaded from environment variables only
Write operations (presigned PUT URLs) are disabled by default
All inputs are validated using Zod schemas
Presigned URLs have configurable expiration (max 7 days)
Logs are written to stderr to avoid interfering with stdio transport
Support
Issues: Report bugs or request features on GitHub
Setup Help: See SETUP_GUIDE.md
Usage Help: See USAGE_GUIDE.md
Examples: Check the examples/ directory
Contributing Contributions are welcome! Please:
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
License
Quick Reference Scrapling MCP Server Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported. Serverless ⚡ Serverless Framework – Effortlessly build apps that auto-scale, incur zero costs when idle, and require minimal maintenance using AWS Lambda and other managed cloud services. Skills The open agent skills tool - npx skills Editor Open-source 3D architecture software for AECO, scan-to-BIM. Agent-friendly, browser-first, MCP, CLI. Trigger.dev Trigger.dev – build and deploy durable AI agents and workflows Open Saas A 100% free modern JS SaaS boilerplate (React, NodeJS, Prisma). Full-featured: Auth (email, google, github, slack, MS), Email sending, Background jobs, Landing page, Payments (Stripe, Polar.sh), Shadc Docker Android Android in docker solution with noVNC supported, video recording, mcp server and AI-agent Awesome Cloudflare ⛅️ 精选的 Cloudflare 工具、开源项目、指南、博客和其他资源列表。/ ⛅️ A curated list of Cloudflare tools, open source projects, guides, blogs and other resources. Casdoor An open-source Agent-first Identity and Access Management (IAM) /LLM MCP & agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, SeleniumBase 📊 Python APIs for Web Automation, Testing, and Scraping. CDP Mode launches a stealth browser that bypasses bot-detection/CAPTCHAs. Adds stealth to Playwright and has an MCP server for AI agents. Pal The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one. Tyk Open Source API and AI Gateway supporting REST, GraphQL, TCP, gRPC and MCP (Model Context Protocol) Cloud infrastructure MCP 服务器 最佳 Cloud infrastructure MCP 服务器 agent-browser Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web a azure-aigateway Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailb
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
如何安装 Aws S3? 在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
Aws S3 需要 API 密钥吗? 此记录未列出必需的环境变量。
Aws S3 使用哪种传输方式? Aws S3 通过 stdio 在本地运行。
Aws S3 上次检查是什么时候? 上次检查时间:2026-10-28。 MCP server exposing AWS S3 tools: list buckets/objects, presigned GET/PUT, safe by default.
azure-compute Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l 工具
0 / 10