s3-tools MCP 서버

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

특징

도구

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

• list-s3-buckets : AWS 계정의 모든 S3 버킷을 나열합니다.

  • AWS 지역을 지정하는 선택적 region 매개변수

  • 버킷 이름의 형식화된 목록을 반환합니다.

Related MCP server: AWS S3 Control MCP Server

필수 조건

• Python 3.13 이상

• AWS 자격 증명이 구성됨( AWS 자격 증명 설정 참조)

• uv 패키지 관리자

설치

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

2. 패키지 빌드:

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

기여하다

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