Sample S3 Model Context Protocol Server

简介

这是一个用于从 S3 中检索数据（如 PDF）的模型上下文协议(MCP)服务器实现。

功能

• 资源：通过资源访问 AWS S3 数据（最多1000个PDF对象）
• 工具：
  • ListBuckets - 列出所有存储桶
  • ListObjectsV2 - 列出存储桶中的对象
  • GetObject - 从S3检索对象

快速设置

1. 配置 AWS 凭证

# 使用默认配置文件配置 AWS 凭证
aws configure
# 输入你的 AWS 访问密钥 ID、秘密访问密钥和区域

确保凭证具有适当的 S3 读/写权限。

2. 配置 Claude Desktop

根据操作系统修改配置文件：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

已发布版本配置:

{
  "mcpServers": {
    "s3-mcp-server": {
      "command": "uvx",
      "args": [
        "s3-mcp-server"
      ]
    }
  }
}

开发版本配置:

{
  "mcpServers": {
    "s3-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/user/generative_ai/model_context_protocol/s3-mcp-server",
        "run",
        "s3-mcp-server"
      ]
    }
  }
}

开发指南

构建和发布

# 同步依赖
uv sync

# 构建包
uv build

# 发布到 PyPI
uv publish

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory /path/to/s3-mcp-server run s3-mcp-server

许可

本项目根据 MIT-0 许可证开源。