s3-tools MCP 服务器

一个提供与 AWS S3 存储桶交互工具的 MCP 服务器。此服务器允许通过模型上下文协议直接访问 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

2. 构建包：

uv build

发布

要发布到 PyPI：

uv publish

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

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

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector 进行开发：

npx @modelcontextprotocol/inspector uv run s3-tools

许可证

MIT

贡献

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