sample-mcp-server-s3

43
cloud_storage

The Sample S3 Model Context Protocol Server is an MCP server designed to retrieve and manage PDF data from Amazon S3. It features resource exposure and tools for listing and getting objects, making it an effective solution for handling S3 data within an MCP context.

OverviewREADMEServer Configs

Sample S3 Model Context Protocol Server

An MCP server implementation for retrieving data such as PDFs from S3.

Features

  • Resources: Expose AWS S3 Data through Resources. Currently supports PDF documents, limited to 1000 objects.
  • Tools:
    • ListBuckets: Returns a list of all buckets owned by the sender.
    • ListObjectsV2: Retrieves up to 1,000 objects in a bucket.
    • GetObject: Gets an object from S3, supporting both virtual-hosted-style and path-style requests.

Configuration

  • Obtain AWS credentials and ensure proper permissions for S3.
  • Usage with Claude Desktop: Provides configuration paths for both MacOS and Windows.

Development

  • Build and publish package distributions using commands like uv sync, uv build, and uv publish. PyPI credentials are needed for publishing.

Debugging

  • Use the MCP Inspector for debugging MCP servers since they run over stdio.