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。