S3工具MCP服务器

s3工具MCP服务器

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

特性

工具

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

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

先决条件

• Python 3.13或更高版本
• 已配置AWS凭据（请参阅 AWS凭据设置)
• 紫外线 包管理器

安装

来自PyPI

uvx install s3-tools

来源

1. 克隆存储库
2. 使用紫外线进行安装：

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"  # optional
   

3. IAM角色 （如果在AWS基础架构上运行）

有关AWS凭据的更多信息，请参阅 AWS文档.

配置

克劳德桌面

将服务器配置添加到Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %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 或 UV_PUBLISH_TOKEN
• 或用户名/密码： --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员 发展：

npx @modelcontextprotocol/inspector uv run s3-tools

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。