项目介绍

file-store-mcp 是一个功能强大的工具，支持多种存储服务提供商（包括阿里云 OSS、腾讯云 COS、七牛云和 GitHub），能够处理文件的上传、下载、删除以及批量操作。它不仅适用于本地开发环境，还能在 Kubernetes 平台无缝运行，并且具备扩展性，可以应对高并发场景。

安装与使用

安装

你可以通过以下命令轻松安装 file-store-mcp：

go install github.com/sjzar/file-store-mcp/cmd/file-store-mcp@latest

使用示例

上传文件到指定存储服务提供商：

file-store-mcp upload --provider oss --config ./config.json

下载指定存储服务提供商中的文件：

file-store-mcp download --provider cos --name "example-file.txt"

删除指定存储服务提供商中的文件：

file-store-mcp delete --provider qiniu --path "images/logo.png"

配置说明

通用配置

在 config.json 文件中，你需要至少指定以下参数：

• Provider: 指定存储服务提供商（oss、cos、qiniu 或 github）。
• AccessKey 和 SecretKey: 对应的访问密钥信息。

各平台具体配置

阿里云 OSS

在 config.json 中填写以下内容：

{
  "provider": "oss",
  "ossEndpoint": "oss-cn-hangzhou.aliyuncs.com",
  "ossAccessKey": "your-access-key",
  "ossSecretKey": "your-secret-key",
  "bucketName": "your-bucket-name"
}

腾讯云 COS

在 config.json 中填写以下内容：

{
  "provider": "cos",
  "region": "ap-southeast-2",
  "cosSecretId": "your-secret-id",
  "cosSecretKey": "your-secret-key",
  "bucketName": "your-bucket-name"
}

七牛云

在 config.json 中填写以下内容：

{
  "provider": "qiniu",
  "accessKey": "your-access-key",
  "secretKey": "your-secret-key",
  "bucketName": "your-bucket-name",
  "domain": "cdn.your-domain.com"
}

GitHub

在 config.json 中填写以下内容：

{
  "provider": "github",
  "token": "your-github-token",
  "owner": "your-repo-owner",
  "repo": "your-repo-name",
  "branch": "main",
  "pathPrefix": "uploads"
}

高级用法

自定义域名

你可以为所有存储服务提供商配置自定义域名，以便通过 CDN 提供更快的文件访问。例如，对于阿里云 OSS：

ossEndpoint=oss-cn-hangzhou.aliyuncs.com
bucketName=my-bucket
ossAccessKey=your-access-key
ossSecretKey=your-secret-key
customDomain=cdn.example.com

调试模式

启用调试模式以获得更详细的日志输出：

file-store-mcp --debug

开发

从源码构建

你可以通过以下步骤从源码构建 file-store-mcp：

git clone https://github.com/sjzar/file-store-mcp.git
cd file-store-mcp
go build -o bin/file-store-mcp ./cmd/file-store-mcp

许可证

file-store-mcp 采用 Apache License 2.0 开源协议，允许用户自由使用、修改和分发。

项目地址

GitHub 地址

联系方式

如需反馈或问题，请联系 作者邮箱。