s3-tools MCP Server

一个提供与 AWS S3 存储桶交互工具的 MCP 服务器。此服务器通过模型上下文协议（Model Context Protocol）直接访问 S3 存储桶操作。

功能

工具

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

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

先决条件

• 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"  # 可选
   

3. IAM 角色 (如果在 AWS 基础设施上运行)

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

配置

Claude Desktop

将服务器配置添加到您的 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

1. 构建包：

uv build

发布

要发布到 PyPI：

uv publish

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

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

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能会有挑战。我们建议使用 MCP Inspector 进行开发：

npx @modelcontextprotocol/inspector uv run s3-tools

许可

MIT

贡献

欢迎贡献！请随时提交 Pull Request。