hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides tools for interacting with AWS S3 buckets, allowing users to list all S3 buckets in their AWS account with optional region specification.

s3-tools MCP 服务器

提供与 AWS S3 bucket 交互工具的 MCP 服务器。该服务器支持通过模型上下文协议 (MCP) 直接访问 S3 bucket 操作。

特征

工具

该服务器目前实现了以下工具：

list-s3-buckets ：列出您的 AWS 账户中的所有 S3 存储桶
- 可选region参数，用于指定 AWS 区域
- 返回存储桶名称的格式化列表

先决条件

Python 3.13 或更高版本
已配置 AWS 凭证（请参阅AWS 凭证设置）
uv包管理器

安装

来自 PyPI

uvx install s3-tools

来自源

克隆存储库
使用 uv 安装：

uv pip install .

AWS凭证设置

此服务器需要 AWS 凭证才能访问您的 S3 存储桶。您可以通过多种方式配置凭证：

AWS CLI 配置（推荐）
aws configure
这将在~/.aws/credentials中创建/更新凭证
环境变量
export AWS_ACCESS_KEY_ID="your_access_key" export AWS_SECRET_ACCESS_KEY="your_secret_key" export AWS_DEFAULT_REGION="your_preferred_region" # optional
IAM 角色（如果在 AWS 基础设施上运行）

有关 AWS 凭证的更多信息，请参阅AWS 文档。

配置

克劳德桌面

将服务器配置添加到您的 Claude Desktop 配置文件：

MacOS ： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows ： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "s3-tools": {
      "command": "uvx",
      "args": ["s3-tools"]
    }
  }
}

开发配置

对于开发/测试，您可以直接从源代码运行服务器：

{
  "mcpServers": {
    "s3-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/s3-tools",
        "run",
        "s3-tools"
      ]
    }
  }
}

发展

建筑

同步依赖项：

uv sync

构建包：

uv build

出版

要发布到 PyPI：

uv publish

注意：您需要通过以下方式配置 PyPI 凭据：

令牌： --token或UV_PUBLISH_TOKEN
或用户名/密码： --username / UV_PUBLISH_USERNAME和--password / UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们建议使用MCP Inspector进行开发：

npx @modelcontextprotocol/inspector uv run s3-tools

执照

麻省理工学院

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

list-s3-buckets

MCP 服务器提供与 AWS S3 存储桶交互的工具，支持通过模型上下文协议直接访问 S3 操作。

Related Resources

Reddit Discussion about this server