S3 MCP Server
2025.04.13
4
TypeScript云存储管理AWS S3 接口数据库
aws-s3-mcp 是一个基于 Amazon S3 的模型上下文协议（MCP）服务器，专为大型语言模型（如 Claude）与 AWS S3 存储交互而设计。它提供了一系列工具，用于列出 S3 存储桶、列出存储桶中的对象以及检索对象内容。该服务器使用 TypeScript 和 MCP SDK 构建，为 LLMs 提供了一个安全、标准化的接口来访问 S3 存储。
View on GitHub
Overview
基本能力
产品定位
aws-s3-mcp 是一个连接大型语言模型与 AWS S3 存储的中间件，旨在简化 LLMs 对云存储资源的访问和管理。
核心功能
- 列出可用 S3 存储桶：列出服务器有权访问的 S3 存储桶，支持通过配置限制可访问的存储桶列表。
- 列出存储桶中的对象：列出指定 S3 存储桶中的对象，支持按前缀过滤和限制返回数量。
- 检索对象内容：从指定 S3 存储桶中检索对象内容，支持文本文件和二进制文件。
适用场景
- 在 LLMs 应用中集成 S3 存储访问能力
- 自动化 S3 存储桶和对象管理
- 通过自然语言指令查询和检索 S3 存储内容
工具列表
- list-buckets：列出可访问的 S3 存储桶。
- list-objects：列出指定存储桶中的对象。
- get-object：检索指定存储桶中的对象内容。
常见问题解答
- 权限问题：确保 AWS 凭证具有适当的 S3 访问权限。
- 配置问题：正确设置环境变量，特别是
S3_BUCKETS和 AWS 凭证。 - Claude Desktop 集成问题：如遇错误，尝试使用绝对路径配置。
使用教程
使用依赖
- Node.js 18 或更高版本
- npm 或 yarn
- 配置好的 AWS 凭证
安装教程
- 通过 npm 安装：
# 全局安装
npm install -g aws-s3-mcp
# 或作为项目依赖安装
npm install aws-s3-mcp
- 从源代码构建：
git clone https://github.com/samuraikun/aws-s3-mcp.git
cd aws-s3-mcp
npm install
npm run build
- 配置 AWS 凭证和 S3 访问：
创建
.env文件：
AWS_REGION=us-east-1
S3_BUCKETS=bucket1,bucket2,bucket3
S3_MAX_BUCKETS=5
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
运行服务器
# 使用 npx
npx aws-s3-mcp
# 全局安装后
aws-s3-mcp
# 从克隆的仓库运行
npm start
# 或直接运行
node dist/index.js
调试方式
- 检查环境变量是否正确设置
- 验证 AWS 凭证权限
- 检查 Claude Desktop 配置文件路径和格式
- 如遇错误，尝试使用绝对路径配置