s3-tools MCP 服务器

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

特征

工具

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

• list-s3-buckets ：列出您的 AWS 账户中的所有 S3 存储桶

  • 可选region参数，用于指定 AWS 区域

  • 返回存储桶名称的格式化列表

Related MCP server: AWS S3 Control MCP Server

先决条件

• Python 3.13 或更高版本

• 已配置 AWS 凭证（请参阅AWS 凭证设置）

• uv包管理器

安装

来自 PyPI

uvx install s3-tools

来自源

1. 克隆存储库

2. 使用 uv 安装：

uv pip install .

AWS凭证设置

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

1. AWS CLI 配置（推荐）

   aws configure

   这将在~/.aws/credentials中创建/更新凭证

2. 环境变量

   export AWS_ACCESS_KEY_ID="your_access_key"
   export AWS_SECRET_ACCESS_KEY="your_secret_key"
   export AWS_DEFAULT_REGION="your_preferred_region"  # optional

3. 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"
      ]
    }
  }
}

发展

建筑

1. 同步依赖项：

uv sync

2. 构建包：

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 请求。