Private
File-store-MCP
2025-04-14
Servicio de archivos MCP Server
3 years
Works with Finder
1
Github Watches
0
Github Forks
1
Github Stars
File Store MCP Server
A file storage service supporting multiple cloud providers
Features
- Multi-cloud storage provider support
- Unified API for file uploads
- Presigned URL generation for secure access
- Support for AWS S3, Alibaba Cloud OSS, Tencent Cloud COS, Qiniu Cloud, and GitHub
- Easy configuration via environment variables
- Customizable URL expiration times
- Support for custom domains and CDNs
- Dual operation modes: stdio for direct integration and SSE for server mode
Quick Start
Installation
go install github.com/sjzar/file-store-mcp@latest
Basic Usage
- Set the required environment variables for your chosen storage provider
- Run in stdio mode (default) for direct integration with other applications:
file-store-mcp - Or run in SSE server mode for HTTP-based integration:
file-store-mcp --sse-port 8080
MCP Tools
File Store MCP provides three tools for uploading files to cloud storage:
1. Upload Files Tool (upload_files)
Uploads local files to cloud storage and returns HTTP URLs.
When to use: When users mention local file paths or need online access to their files. Ideal for analyzing PDF content, referencing local images for drawing tasks, or processing any local files.
Parameters:
-
paths: Array of absolute local file paths to upload (required)
Example:
{
"tool": "upload_files",
"params": {
"paths": ["/path/to/file1.pdf", "C:/Users/user/Documents/file2.jpg"]
}
}
2. Upload Clipboard Files Tool (upload_clipboard_files)
Uploads files from the clipboard to cloud storage and returns HTTP URLs.
When to use: Only when users explicitly request to upload files from their clipboard. Useful when users want to share or process clipboard content without saving it locally first.
Parameters: None required
Example:
{
"tool": "upload_clipboard_files"
}
3. Upload URL Files Tool (upload_url_files)
Downloads files from provided URLs and uploads them to cloud storage, returning new HTTP URLs.
When to use: When users provide web links to files they want to process or analyze. Ideal for situations where users reference external files that need to be incorporated into the current workflow.
Parameters:
-
urls: Array of URLs pointing to files to download and upload (required)
Example:
{
"tool": "upload_url_files",
"params": {
"urls": ["https://example.com/file1.pdf", "https://another-site.org/image.jpg"]
}
}
Storage Providers
File Store MCP supports the following storage providers:
- AWS S3 (and compatible services like Cloudflare R2)
- Alibaba Cloud OSS
- Tencent Cloud COS
- Qiniu Cloud Storage
- GitHub Repository
Configuration
Common Configuration
| Environment Variable | Description | Default |
|---|---|---|
FSM_STORAGE_TYPE |
Storage provider type (s3, oss, cos, qiniu, github) | empty |
AWS S3 Configuration
Set FSM_STORAGE_TYPE=s3 to use AWS S3 or compatible services.
| Environment Variable | Description | Required | Default |
|---|---|---|---|
FSM_S3_BUCKET |
S3 bucket name | Yes | - |
FSM_S3_REGION |
AWS region | Yes | - |
FSM_S3_ENDPOINT |
Custom endpoint for S3-compatible services | No | AWS S3 endpoint |
FSM_S3_ACCESS_KEY |
AWS access key ID | Yes | - |
FSM_S3_SECRET_KEY |
AWS secret access key | Yes | - |
FSM_S3_SESSION |
AWS session token | No | - |
FSM_S3_URL_EXPIRATION |
Presigned URL expiration time in seconds | No | 604800 (7 days) |
Notes for S3-compatible services:
- For Cloudflare R2: Set
FSM_S3_ENDPOINTto your R2 endpoint URL - For other S3-compatible services: Configure the appropriate endpoint URL
Alibaba Cloud OSS Configuration
Set FSM_STORAGE_TYPE=oss to use Alibaba Cloud OSS.
| Environment Variable | Description | Required | Default |
|---|---|---|---|
FSM_OSS_ENDPOINT |
OSS endpoint | Yes | - |
FSM_OSS_ACCESS_KEY |
OSS access key ID | Yes | - |
FSM_OSS_SECRET_KEY |
OSS access key secret | Yes | - |
FSM_OSS_BUCKET |
OSS bucket name | Yes | - |
FSM_OSS_DOMAIN |
Custom domain for OSS bucket | No | - |
FSM_OSS_URL_EXPIRATION |
Signed URL expiration time in seconds | No | 604800 (7 days) |
Tencent Cloud COS Configuration
Set FSM_STORAGE_TYPE=cos to use Tencent Cloud COS.
| Environment Variable | Description | Required | Default |
|---|---|---|---|
FSM_COS_BUCKET |
COS bucket name | Yes | - |
FSM_COS_REGION |
COS region | Yes | - |
FSM_COS_APP_ID |
Tencent Cloud App ID | Yes | - |
FSM_COS_ACCESS_KEY |
Secret ID | Yes | - |
FSM_COS_SECRET_KEY |
Secret Key | Yes | - |
FSM_COS_DOMAIN |
Custom domain for COS bucket | No | - |
FSM_COS_USE_HTTPS |
Whether to use HTTPS | No | true |
FSM_COS_USE_ACCELERATE |
Whether to use global acceleration | No | false |
FSM_COS_URL_EXPIRATION |
Presigned URL expiration time in seconds | No | 604800 (7 days) |
Qiniu Cloud Storage Configuration
Set FSM_STORAGE_TYPE=qiniu to use Qiniu Cloud Storage.
| Environment Variable | Description | Required | Default |
|---|---|---|---|
FSM_QINIU_ACCESS_KEY |
Qiniu access key | Yes | - |
FSM_QINIU_SECRET_KEY |
Qiniu secret key | Yes | - |
FSM_QINIU_BUCKET |
Qiniu bucket name | Yes | - |
FSM_QINIU_DOMAIN |
Custom domain for Qiniu bucket (required) | Yes | - |
FSM_QINIU_REGION |
Storage region | No | z0 (East China) |
FSM_QINIU_URL_EXPIRATION |
Signed URL expiration time in seconds | No | 604800 (7 days) |
Available Qiniu regions:
-
z0: East China -
z1: North China -
z2: South China -
na0: North America -
as0: Southeast Asia
GitHub Repository Configuration
Set FSM_STORAGE_TYPE=github to use GitHub as a storage provider.
| Environment Variable | Description | Required | Default |
|---|---|---|---|
FSM_GITHUB_TOKEN |
GitHub personal access token | Yes | - |
FSM_GITHUB_OWNER |
Repository owner | Yes | - |
FSM_GITHUB_REPO |
Repository name | Yes | - |
FSM_GITHUB_BRANCH |
Branch name | No | main |
FSM_GITHUB_PATH |
File storage path within the repository | No | - |
FSM_GITHUB_DOMAIN |
Custom domain for GitHub content | No | - |
GitHub token permissions:
- The token must have
reposcope for private repositories - For public repositories,
public_reposcope is sufficient
Advanced Usage
Using Custom Domains
For all storage providers, you can configure custom domains to serve your files. This is particularly useful when you have CDN services in front of your storage.
Example for Alibaba Cloud OSS with custom domain:
FSM_STORAGE_TYPE=oss
FSM_OSS_BUCKET=my-bucket
FSM_OSS_ENDPOINT=oss-cn-hangzhou.aliyuncs.com
FSM_OSS_ACCESS_KEY=your-access-key
FSM_OSS_SECRET_KEY=your-secret-key
FSM_OSS_DOMAIN=cdn.example.com
Debug Mode
Enable debug mode for more verbose logging:
file-store-mcp --debug
Development
Building from Source
git clone https://github.com/sjzar/file-store-mcp.git
cd file-store-mcp
go build
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
相关推荐
🔥 1Panel proporciona una interfaz web intuitiva y un servidor MCP para administrar sitios web, archivos, contenedores, bases de datos y LLM en un servidor de Linux.
⛓️Rulego es un marco de motor de regla de orquestación de componentes de alta generación de alto rendimiento, de alto rendimiento y de alto rendimiento para GO.
🧑🚀 全世界最好的 llM 资料总结（数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型） | Resumen de los mejores recursos del mundo.
Traducción de papel científico en PDF con formatos preservados - 基于 Ai 完整保留排版的 PDF 文档全文双语翻译 ， 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 等服务 等服务 等服务 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 cli/mcp/docker/zotero
Cree fácilmente herramientas y agentes de LLM utilizando funciones Plain Bash/JavaScript/Python.
😎简单易用、🧩丰富生态 - 大模型原生即时通信机器人平台 | 适配 Qq / 微信（企业微信、个人微信） / 飞书 / 钉钉 / Discord / Telegram / Slack 等平台 | 支持 Chatgpt 、 Deepseek 、 DiFy 、 Claude 、 Gemini 、 Xai 、 PPIO 、 Ollama 、 LM Studio 、阿里云百炼、火山方舟、 Siliconflow 、 Qwen 、 Moonshot 、 Chatglm 、 SillyTraven 、 MCP 等 LLM 的机器人 / Agente | Plataforma de bots de mensajería instantánea basada en LLM, admite Discord, Telegram, WeChat, Lark, Dingtalk, QQ, Slack
Una puerta de enlace basada en complementos que orquesta otros MCP y permite a los desarrolladores construir sobre agentes de grado empresarial de TI.
Iniciar aplicaciones de múltiples agentes empoderadas con Building LLM de manera más fácil.
Reviews
2.3
(14)
user_QBIPUDR0
2025-04-26
I've been using file-store-mcp by sjzar, and it's simply outstanding! The seamless integration and user-friendly interface make managing files effortlessly efficient. This tool has significantly streamlined my workflow, and I couldn't be more satisfied. Highly recommended for anyone in need of a reliable file management solution!
user_gr4RMZRi
2025-04-26
I've been using file-store-mcp by sjzar and it has transformed how I manage my files. The user experience is smooth and intuitive, making it a breeze to store and retrieve files. Highly recommended for anyone looking for a reliable file management solution!
user_VkwEkxoY
2025-04-26
The file-store-mcp by sjzar is simply outstanding! As an avid user, I appreciate the seamless functionality and user-friendly interface. It has significantly simplified file management for me. Highly recommend!
user_JbmDb6KT
2025-04-26
File-store-mcp by sjzar has been a game-changer for my data storage needs. The seamless integration and user-friendly interface make managing and accessing files incredibly efficient. Highly recommend it for anyone looking for a robust and reliable storage solution!
user_GzRZOXnZ
2025-04-26
file-store-mcp is an exceptional application! It offers seamless file storage and management, ensuring all my documents are organized and easily accessible. The interface is user-friendly, and the performance is highly reliable. Kudos to sjzar for developing such a practical tool. Highly recommend it to anyone needing efficient file storage solutions!
user_j1RIu67I
2025-04-26
File-store-mcp is an outstanding application created by sjzar that has completely transformed the way I manage and store my files. The intuitive interface makes it incredibly easy to use, and its seamless integration with my workflow is remarkable. I highly recommend this tool to anyone looking for a reliable and efficient file management solution.
user_DwuC9Owc
2025-04-26
file-store-mcp by sjzar is an incredible tool for anyone in need of efficient file management. Its seamless integration and user-friendly interface make it easy to organize and retrieve files quickly. A must-have for professionals who value productivity and efficiency!
user_5oIfC4gP
2025-04-26
I've been using the file-store-mcp by sjzar, and it's fantastic! The interface is intuitive, which makes managing my files a breeze. The performance is top-notch, and I appreciate the constant updates and improvements from the developer. Highly recommend this tool for anyone needing efficient file management.
user_lXHlHd9F
2025-04-26
As a loyal user of file-store-mcp by sjzar, I find it incredibly reliable and efficient for managing my files. The user interface is intuitive, and the performance has been top-notch. It has seamlessly integrated into my workflow, saving me time and effort. Highly recommended for anyone in need of a robust file management solution!
user_1XIGas57
2025-04-26
file-store-mcp is an efficient and reliable tool for managing and organizing files. As a loyal user, I can attest to its seamless performance and user-friendly interface. Created by sjzar, it simplifies file storage needs significantly. Highly recommend for anyone looking to streamline their file management process!
user_zQ7gFWmK
2025-04-26
File-store-mcp by sjzar is an outstanding application for effective file storage management. It offers seamless integration and a user-friendly interface that simplifies the process of organizing and accessing files. A must-have tool for anyone looking to enhance their file management system!
user_n2cMnhqp
2025-04-26
As a loyal user of file-store-mcp, I am thoroughly impressed with its efficiency and user-friendliness. Designed by sjzar, this tool has greatly simplified my file management processes. The seamless integration and intuitive interface make it a must-have for anyone looking to streamline their file storage. Highly recommend!
user_Exo37Wsz
2025-04-26
The File-Store-MCP by sjzar has been a game-changer for my document management. It’s user-friendly, efficient, and has made organizing my files a breeze. The setup was seamless, and the interface makes it easy to access and manage files. A must-have for anyone looking to streamline their file storage!
user_EWBqPWdv
2025-04-26
File-store-mcp is an exceptional application created by sjzar. It has greatly improved my file management with its user-friendly interface and seamless functionality. I highly recommend it to anyone looking for a reliable solution to manage their files efficiently.