Skip to main content
Glama
bramato

saveformedearai

by bramato
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

SaveForMeDearAI

npm version npm downloads License: MIT GitHub stars TypeScript S3

A Model Context Protocol (MCP) server for managing files on S3 storage, supporting AWS S3 and DigitalOcean Spaces.

Features

  • 🚀 Upload public and private files with metadata

  • 📋 List files with descriptions and information

  • 🔗 Immediate URL access - URLs returned directly in upload response

  • 🌍 Global and local configuration for projects

  • ⚡ Multi-provider support (AWS S3, DigitalOcean Spaces, S3-compatible)

  • 🎯 Claude Code integration via MCP

Related MCP server: S3-Compatible 3D Storage MCP Server

Installation

Global Installation

npm install -g saveformedearai

Installation from Source

git clone https://github.com/bramato/saveForMeDearAi.git
cd saveForMeDearAi
npm install
npm run build
npm install -g .

Configuration

Quick Setup (2 steps)

  1. Install and configure:

npm install -g saveformedearai
saveformedearai setup

  1. Add to Claude MCP config:

{
  "mcpServers": {
    "saveformedearai": {
      "command": "saveformedearai"
    }
  }
}

Available Commands

# Configure S3 drive (global)
saveformedearai setup

# Initialize local project
saveformedearai init

# Start MCP server (automatic when called by Claude)
saveformedearai

Configuration Structure

Global Configuration

Saved in ~/.saveformedearai/config.json:

{
  "defaultDrive": "my-aws-drive",
  "drives": {
    "my-aws-drive": {
      "endpoint": "https://s3.amazonaws.com",
      "region": "us-east-1",
      "accessKeyId": "YOUR_ACCESS_KEY",
      "secretAccessKey": "YOUR_SECRET_KEY",
      "bucketName": "my-bucket"
    }
  }
}

Local Configuration

Saved in .claude/saveformedearai.json:

{
  "driveName": "my-project-drive",
  "projectDirectory": "my-project",
  "s3Config": {
    "endpoint": "https://nyc3.digitaloceanspaces.com",
    "region": "nyc3",
    "accessKeyId": "YOUR_DO_KEY",
    "secretAccessKey": "YOUR_DO_SECRET",
    "bucketName": "my-space"
  }
}

Available MCP Tools

1. save_public_file

Save a file as public and return the permanent URL.

{
  "filePath": "/path/to/file.jpg",
  "filename": "optional-custom-name.jpg", // optional
  "description": "File description" // optional
}

Response:

{
  "success": true,
  "url": "https://bucket.endpoint.com/file.jpg",
  "key": "file.jpg",
  "urlType": "permanent",
  "isPublic": true,
  "message": "File uploaded successfully as public file. URL: https://bucket.endpoint.com/file.jpg",
  "driveName": "my-drive"
}

2. save_private_file

Save a file as private.

{
  "filePath": "/path/to/private-file.pdf",
  "filename": "document.pdf",
  "description": "Private document"
}

Response:

{
  "success": true,
  "key": "document.pdf",
  "url": "https://presigned-url...",
  "temporaryUrl": "https://presigned-url...",
  "urlType": "temporary",
  "expiresIn": 3600,
  "expirationDate": "2024-01-15T11:30:00Z",
  "message": "File uploaded successfully as private file. Temporary URL provided (expires in 1 hour).",
  "driveName": "my-drive"
}

3. list_files

List all files with metadata.

{
  "prefix": "images/" // optional, filter by prefix
}

Response:

{
  "success": true,
  "files": [
    {
      "filename": "image.jpg",
      "description": "Sample photo",
      "uploadDate": "2024-01-15T10:30:00Z",
      "isPublic": true,
      "size": 1024000,
      "contentType": "image/jpeg",
      "sizeFormatted": "1.02 MB"
    }
  ],
  "count": 1,
  "driveName": "my-drive"
}

4. get_file_url

Get URL for a file (permanent for public, temporary for private).

{
  "filename": "document.pdf",
  "expiresIn": 3600 // optional, seconds (max 7 days)
}

Response for public file:

{
  "success": true,
  "url": "https://bucket.endpoint.com/document.pdf",
  "urlType": "permanent",
  "isPublic": true,
  "filename": "document.pdf"
}

Response for private file:

{
  "success": true,
  "url": "https://presigned-url...",
  "urlType": "temporary",
  "isPublic": false,
  "expiresIn": 3600,
  "expirationDate": "2024-01-15T11:30:00Z"
}

Provider Support

AWS S3

Endpoint: https://s3.amazonaws.com
Force Path Style: false

DigitalOcean Spaces

Endpoint: https://[region].digitaloceanspaces.com
Force Path Style: false

S3-Compatible (Minio, etc.)

Endpoint: https://your-endpoint.com
Force Path Style: true (typically)

Development

# Clone repository
git clone https://github.com/bramato/saveForMeDearAi.git
cd saveForMeDearAi

# Install dependencies
npm install

# Build
npm run build

# Development with watch
npm run dev

# Test locally
npm start

Troubleshooting

Error "No configuration found"

Run saveformedearai setup to configure an S3 drive.

S3 connection error

Verify:

  • Correct credentials

  • Correct endpoint for provider

  • Bucket exists and is accessible

  • Adequate permissions (read/write for bucket)

File not found

Use list_files to verify file names in the bucket.

License

MIT

Contributing

Contributions are welcome! Please open an issue or pull request.

🎵 Support the Developer

Love coding with chill vibes? Support this project by listening to my developer album:

"Code Chill: Loops of Relaxation" 🎧

Perfect background music for your coding sessions

Listen on Apple Music Listen on Spotify Listen on YouTube Music

Every stream helps support the development of free tools like this one! 🙏

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bramato/saveForMeDearAi'

If you have feedback or need assistance with the MCP directory API, please join our Discord server