AWS S3 MCP 서버

AWS S3 작업을 위한 MCP 서버로, 사전 서명된 URL을 통해 S3 버킷에 대한 안전한 액세스를 제공합니다.

도구

1. list_objects

   • S3 버킷의 객체 나열

   • 입력:

     • prefix (문자열, 선택 사항): 객체 키에 대한 접두사 필터

   • 반환: 키, 크기 및 마지막 수정 날짜가 포함된 객체 배열

2. get_object

   • 객체에 액세스하기 위한 사전 서명된 URL 생성

   • 입력:

     • key (문자열, 필수): 검색할 개체 키

     • expiry (숫자, 선택 사항): URL 만료 시간(초)(기본값: 3600)

   • 반환: 미리 서명된 URL을 포함하는 object_url

3. put_object

   • 객체를 업로드하기 위한 사전 서명된 URL을 생성합니다.

   • 입력:

     • key (문자열, 필수): 업로드할 객체 키

     • expiry (숫자, 선택 사항): URL 만료 시간(초)(기본값: 3600)

   • 반환: 미리 서명된 URL을 포함하는 upload_url

4. delete_object

   • 버킷에서 객체를 삭제합니다

   • 입력:

     • key (문자열, 필수): 삭제할 개체 키

   • 반환: 삭제 상태를 나타내는 success 부울 값

Related MCP server: S3 MCP Server

설정

환경 변수

서버에는 다음과 같은 환경 변수가 필요합니다.

• BUCKET_NAME : S3 버킷의 이름(필수)

• REGION : AWS 지역(기본값: "ap-southeast-1")

AWS 자격 증명은 표준 AWS 자격 증명 구성 방법(환경 변수, IAM 역할 또는 AWS 자격 증명 파일)을 사용하여 구성해야 합니다.

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

지엑스피1

NPX 명령

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

짓다

Docker 빌드:

docker build -t mcp/aws-ow-s3-mcp-server .

개발

서버는 다음을 사용하여 구축되었습니다.

• 노드.js

• 타입스크립트

• @modelcontextprotocol/sdk

• @aws-sdk/클라이언트-s3

• @aws-sdk/s3-요청-사전 서명자

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.