File Store MCP

🚀 file-store-mcp

file-store-mcp 是一款功能強大的工具，它支持多種存儲服務提供商，像阿里雲 OSS、騰訊雲 COS、七牛雲和 GitHub 都在其支持範圍內。該工具可處理文件的上傳、下載、刪除及批量操作，既適用於本地開發環境，也能在 Kubernetes 平臺無縫運行，還具備擴展性，可應對高併發場景。

🚀 快速開始

file-store-mcp 支持多種存儲服務提供商，可處理文件的上傳、下載、刪除及批量操作，並且能在本地開發環境和 Kubernetes 平臺運行，擴展性良好，可應對高併發場景。

✨ 主要特性

• 支持多種存儲服務提供商，包括阿里雲 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 地址

聯繫方式

如需反饋或問題，請聯繫 作者郵箱。