drio
Open app

Sample S3 Model Context Protocol Server

Source

Catalog onlyCatalog onlySTDIO

Overview

The Sample S3 Model Context Protocol Server is an implementation designed to retrieve data, specifically PDF documents, from AWS S3 storage using the Model Context Protocol (MCP).

To use the server, set up your AWS credentials, configure the server settings, and run the server to expose S3 data through defined resources.

  • Exposes AWS S3 data through resources, acting like GET endpoints. - Supports retrieval of PDF documents from S3, limited to 1000 objects. - Provides tools for listing buckets and objects, and retrieving specific objects from S3.
  1. Accessing and retrieving PDF documents stored in S3 for data analysis.
  2. Integrating S3 data retrieval into applications using the Model Context Protocol.
  3. Facilitating the development of AI models that require access to external data sources.

Add to your AI client

Use these steps to connect Sample S3 Model Context Protocol Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "sample-mcp-server-s3-aws-samples": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sample-mcp-server-s3-aws-samples"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "sample-mcp-server-s3-aws-samples": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sample-mcp-server-s3-aws-samples"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "sample-mcp-server-s3-aws-samples": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sample-mcp-server-s3-aws-samples"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "sample-mcp-server-s3-aws-samples": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sample-mcp-server-s3-aws-samples"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sample-mcp-server-s3-aws-samples": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sample-mcp-server-s3-aws-samples"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "sample-mcp-server-s3-aws-samples": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sample-mcp-server-s3-aws-samples"
      ]
    }
  }
}

FAQ

What types of documents can be retrieved?

Currently, only PDF documents are supported.

How do I configure my AWS credentials?

Obtain your AWS access key ID, secret access key, and region from the AWS Management Console and configure them in your credentials files.

Is there a limit to the number of objects I can retrieve?

Yes, the server currently supports a limit of 1000 objects.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1189,"uuid":"da4cbdab-14ea-4fc0-a523-8e14bca5d8c9","name":"sample-mcp-server-s3","title":"Sample S3 Model Context Protocol Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/8931462?v=4","created_at":"2025-01-28T02:37:05.983Z","updated_at":"2025-02-23T07:13:18.477Z","status":"created","author_name":"aws-samples","author_avatar_url":"https://avatars.githubusercontent.com/u/8931462?v=4","tags":"[]","category":"cloud-platforms","is_featured":false,"sort":1,"url":"https://github.com/aws-samples/sample-mcp-server-s3","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"12\",\"license\":\"MIT-0 license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2024-12-31 14:39:38\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Cloud platforms