JinDaGe - S3 Tools MCP Details

article

README

🚀 s3工具 MCP 服务器

s3工具 MCP 服务器是一个强大的工具，它提供了与 AWS S3 桶交互的能力。通过 Model Context Protocol，该服务器实现了对 S3 桶操作的直接访问，让用户能够更便捷地管理 AWS S3 资源。

🚀 快速开始

在使用 s3 工具 MCP 服务器之前，你需要确保满足以下先决条件：

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

✨ 主要特性

工具

当前实现的工具如下：

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

📦 安装指南

从 PyPI

uvx 安装 s3-tools

从源码

克隆仓库
使用 uv 安装：

uv pip 安装 .

📚 详细文档

AWS 凭证设置

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

AWS CLI 配置（推荐）
```
aws 配置
```
这将创建/更新 ~/.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"  # 可选

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

开发

构建

同步依赖：

uv sync

构建包：

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。

S3 Tools