MCP.so
登录

Sample S3 Model Context Protocol Server

@aws-samples

关于 Sample S3 Model Context Protocol Server

暂无概览

基本信息

分类

文件与存储

许可证

MIT-0

运行时

python

传输方式

stdio

发布者

aws-samples

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "sample-mcp-server-s3": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

工具

3

Returns a list of all buckets owned by the authenticated sender of the request

Returns some or all (up to 1,000) of the objects in a bucket with each request

Retrieves an object from Amazon S3. In the GetObject request, specify the full key name for the object. General purpose buckets - Both the virtual-hosted-style requests and the path-style requests are supported

概览

What is Sample S3 Model Context Protocol Server?

An MCP server implementation for retrieving data such as PDFs from AWS S3, intended for use with LLMs to load information into context.

How to use Sample S3 Model Context Protocol Server?

Obtain AWS credentials with appropriate S3 permissions, then configure the server in Claude Desktop's config file using either the development command (uv) or the published server command (uvx). The server provides tools and resources for interacting with S3 buckets and objects.

Key features of Sample S3 Model Context Protocol Server?

  • Exposes AWS S3 data through MCP Resources (PDF documents only, limit 1000 objects)
  • Provides ListBuckets tool to list all buckets owned by the authenticated sender
  • Provides ListObjectsV2 tool to list up to 1000 objects in a bucket
  • Provides GetObject tool to retrieve an object by its full key name
  • Supports virtual-hosted-style and path-style requests for GetObject

Use cases of Sample S3 Model Context Protocol Server?

  • Load PDF documents from S3 into an LLM's context for analysis
  • List all S3 buckets accessible to the authenticated AWS account
  • Retrieve specific objects from S3 by key for downstream processing
  • Enumerate objects in a bucket using the ListObjectsV2 tool

FAQ from Sample S3 Model Context Protocol Server

What file formats are supported?

Only PDF documents are currently supported for resource retrieval.

Is there a limit on the number of objects?

Yes, the server is limited to 1000 objects per request.

How do I authenticate with AWS?

Obtain an AWS access key ID, secret access key, and region from the AWS Management Console, and ensure the credentials have appropriate S3 permissions.

How can I debug the server?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector uv --directory <path> run s3-mcp-server.

Where does the server configuration go?

For Claude Desktop, add the server configuration to claude_desktop_config.json (located in ~/Library/Application Support/Claude/ on macOS or %APPDATA%/Claude/ on Windows).

评论

文件与存储 分类下的更多 MCP 服务器