S3 Tools

🚀 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

从源码

1. 克隆仓库
2. 使用 uv 安装：

uv pip 安装 .

📚 详细文档

AWS 凭证设置

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

1. AWS CLI 配置（推荐）

   aws 配置
   

   这将创建/更新 ~/.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。