Sample S3 MCP Server

What does “Sample S3” MCP Server do?

The Sample S3 MCP Server is an implementation of the Model Context Protocol (MCP) designed to connect AI assistants and agents with data stored in AWS S3 buckets. By exposing S3 resources as MCP resources and tools, it enables AI-driven workflows to retrieve, manage, and interact with files—specifically PDF documents—stored in S3. This empowers developers and AI tools to perform tasks like listing buckets, enumerating objects, and retrieving documents, directly enhancing productivity and automation in development environments that require access to cloud-based files. The server is particularly useful for enriching AI context with external data, supporting advanced use cases in document analysis, enterprise search, and more.

List of Prompts

No information found in the repository regarding prompt templates.

List of Resources

• AWS S3 Data (PDF Documents):
  • Exposes PDF documents stored in AWS S3 buckets as MCP resources. These resources can be loaded into an LLM’s context for further processing or analysis.
  • Supports up to 1,000 objects per request.

List of Tools

• ListBuckets
  • Returns a list of all S3 buckets owned by the authenticated AWS account.
• ListObjectsV2
  • Retrieves up to 1,000 objects (files) from a specified S3 bucket in a single request.
• GetObject
  • Downloads or retrieves a specific object (such as a PDF) from a given S3 bucket by key.

Use Cases of this MCP Server

• Document Retrieval and Analysis
  • Enables AI systems to fetch and analyze PDF documents from S3 for tasks like summarization, extraction, and classification.
• Enterprise File Management
  • Allows developers to browse and manage large collections of company documents stored in S3 through an AI assistant.
• Automated Reporting
  • Facilitates the automation of report generation workflows by retrieving raw data or reports stored in S3.
• Contextual Search
  • Supports advanced search and retrieval operations for files, enabling context-enriched interactions in AI-powered applications.
• Data Auditing
  • Assists in auditing and compliance by listing and accessing documents across S3 buckets for review and record keeping.

How to set it up

Windsurf

No specific Windsurf setup instructions found.

Claude

1. Prerequisites: Install the server and ensure AWS credentials (access key, secret, region) are configured with appropriate S3 permissions.
2. Locate Configuration:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Add MCP Server to Configuration:
   Example for development/unpublished server:

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

   Example for published server:

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

4. Save and Restart: Save the configuration file and restart Claude Desktop.
5. Verify Setup: Confirm the S3 MCP server appears in the available tool list.

Securing API Keys

Specify AWS credentials using environment variables or the AWS credentials file (see AWS CLI config docs). Example:

{
  "env": {
    "AWS_ACCESS_KEY_ID": "your-access-key",
    "AWS_SECRET_ACCESS_KEY": "your-secret-key",
    "AWS_DEFAULT_REGION": "your-region"
  },
  "inputs": {}
}

Cursor

No Cursor setup instructions found.

Cline

No Cline setup instructions found.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "s3-mcp-server": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “s3-mcp-server” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the information provided and the structure of the repository, the Sample S3 MCP Server is a focused, well-scoped MCP server for S3-based PDF retrieval and management. It covers core MCP primitives (resources, tools), offers clear setup instructions for Claude, and follows good practices for security and licensing. However, it lacks details on prompts, sampling, and support for platforms like Windsurf and Cursor.

I would rate this MCP server a 7 out of 10 due to its clear S3 integration and tool/resource exposure, but with some missing documentation and features for broader protocol coverage.

MCP Score