s3-tools

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides tools for interacting with AWS S3 buckets, allowing users to list all S3 buckets in their AWS account with optional region specification.

s3-tools MCP 서버

AWS S3 버킷과 상호 작용하기 위한 도구를 제공하는 MCP 서버입니다. 이 서버를 사용하면 모델 컨텍스트 프로토콜(Model Context Protocol)을 통해 S3 버킷 작업에 직접 액세스할 수 있습니다.

특징

도구

현재 서버는 다음 도구를 구현하고 있습니다.

  • list-s3-buckets : AWS 계정의 모든 S3 버킷을 나열합니다.
    • AWS 지역을 지정하는 선택적 region 매개변수
    • 버킷 이름의 형식화된 목록을 반환합니다.

필수 조건

설치

PyPI에서

지엑스피1

출처에서

  1. 저장소를 복제합니다
  2. uv를 사용하여 설치:
uv pip install .

AWS 자격 증명 설정

이 서버에서는 S3 버킷에 액세스하기 위해 AWS 자격 증명이 필요합니다. 자격 증명은 여러 가지 방법으로 구성할 수 있습니다.

  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
  1. 패키지 빌드:
uv build

출판

PyPI에 게시하려면:

uv publish

참고: 다음을 통해 PyPI 자격 증명을 구성해야 합니다.

  • 토큰: --token 또는 UV_PUBLISH_TOKEN
  • 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME--password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 개발에는 MCP Inspector를 사용하는 것이 좋습니다.

npx @modelcontextprotocol/inspector uv run s3-tools

특허

MIT

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

AWS S3 버킷과 상호 작용하기 위한 도구를 제공하는 MCP 서버로, Model Context Protocol을 통해 S3 작업에 직접 액세스할 수 있습니다.

  1. Features
    1. Tools
  2. Prerequisites
    1. Installation
      1. From PyPI
      2. From Source
    2. AWS Credentials Setup
      1. Configuration
        1. Claude Desktop
        2. Development Configuration
      2. Development
        1. Building
        2. Publishing
        3. Debugging
      3. License
        1. Contributing
          ID: gwm71t70bc