bucketlens

Local install

io.github.Pritom14/bucketlensv0.1.0 GitHub verified

Let AI agents read the PDFs and spreadsheets in your S3 or R2 bucket: outlines, search, SQL.

Data & Databases

Watch Source

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-15T19:12:07.816427Z",
      "publishedAt": "2026-11-15T19:12:07.816427Z",
      "statusChangedAt": "2026-11-15T19:12:07.816427Z"
    }
  },
  "server": {
    "name": "io.github.Pritom14/bucketlens",
    "title": "bucketlens",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.1.0",
    "packages": [
      {
        "version": "0.1.0",
        "transport": {
          "type": "stdio"
        },
        "identifier": "bucketlens",
        "runtimeHint": "uvx",
        "registryType": "pypi",
        "registryBaseUrl": "https://pypi.org",
        "packageArguments": [
          {
            "type": "positional",
            "value": "serve"
          }
        ],
        "environmentVariables": [
          {
            "name": "BUCKETLENS_BUCKET",
            "isRequired": true,
            "description": "Bucket to read"
          },
          {
            "name": "BUCKETLENS_ACCESS_KEY_ID",
            "isSecret": true,
            "isRequired": true,
            "description": "Access key that can read the bucket and write under .bucketlens/"
          },
          {
            "name": "BUCKETLENS_SECRET_ACCESS_KEY",
            "isSecret": true,
            "isRequired": true,
            "description": "Secret for that access key"
          },
          {
            "name": "BUCKETLENS_R2_ACCOUNT_ID",
            "description": "Cloudflare account ID (for R2; sets the endpoint for you)"
          },
          {
            "name": "BUCKETLENS_ENDPOINT",
            "description": "S3 endpoint URL (for AWS S3, MinIO or other S3-compatible storage)"
          },
          {
            "name": "BUCKETLENS_REGION",
            "default": "us-east-1",
            "description": "Region (auto for R2)"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/Pritom14/bucketlens",
      "source": "github"
    },
    "description": "Let AI agents read the PDFs and spreadsheets in your S3 or R2 bucket: outlines, search, SQL."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM StudioThen replace the YOUR_ values and {placeholders} with your own.

Run in a terminal

claude mcp add bucketlens \
  -e BUCKETLENS_BUCKET=YOUR_BUCKETLENS_BUCKET \
  -e BUCKETLENS_ACCESS_KEY_ID=YOUR_BUCKETLENS_ACCESS_KEY_ID \
  -e BUCKETLENS_SECRET_ACCESS_KEY=YOUR_BUCKETLENS_SECRET_ACCESS_KEY \
  -- uvx bucketlens==0.1.0

Environment

BUCKETLENS_BUCKET (required): Bucket to read
BUCKETLENS_ACCESS_KEY_ID (required): Access key that can read the bucket and write under .bucketlens/
BUCKETLENS_SECRET_ACCESS_KEY (required): Secret for that access key
BUCKETLENS_R2_ACCOUNT_ID (optional, not in the config above): Cloudflare account ID (for R2; sets the endpoint for you)
BUCKETLENS_ENDPOINT (optional, not in the config above): S3 endpoint URL (for AWS S3, MinIO or other S3-compatible storage)
BUCKETLENS_REGION (optional, not in the config above): Region (auto for R2)

Tools

We don't run packages, so we can't list this server's tools.