Oss MCP

🚀 OSS MCP 服務器

OSS MCP 服務器是一款基於 Model Context Protocol (MCP) 的實用工具，它能將文件便捷地上傳至阿里雲的 Object Storage Service (OSS)。該工具支持通過命令行界面或 HTTP 協議啟動，具備多種功能，可有效簡化文件管理工作。

🚀 快速開始

OSS MCP 服務器可幫助您輕鬆將文件上傳到阿里雲 OSS。您可以按照以下步驟進行安裝、配置和使用。

✨ 主要特性

• 支持通過標準輸入輸出 (stdio) 或 HTTP 協議啟動服務器。
• 提供可配置的 OSS 賬號管理，能輕鬆添加和切換多個存儲桶。
• 內置文件上傳工具，支持自定義目錄、文件名及存儲路徑。
• 擁有可擴展的命令行接口，便於與其他工具和服務集成。

📦 安裝指南

命令行安裝

npm install -g oss-mcp

從源碼安裝

git clone https://github.com/1yhy/oss-mcp.git
cd oss-mcp
pnpm install

📚 詳細文檔

配置方法

環境變量配置

通過環境變量設置阿里雲的訪問密鑰：

export ACCESS_KEY="your_access_key"
export ACCESS_SECRET="your_access_secret"

在 config.json 文件中添加存儲桶信息：

{
  "oss_configs": {
    "default": {
      "region": "oss-cn-shenzhen",
      "bucket": "your_bucket_name"
    }
  }
}

多賬號管理

要配置多個阿里雲賬號，可以在 config.json 中添加多個存儲桶配置：

{
  "oss_configs": {
    "default": {
      "region": "oss-cn-shenzhen",
      "bucket": "your_bucket_name"
    },
    "test": {
      "region": "oss-cn-hangzhou",
      "bucket": "test_bucket_name"
    }
  }
}

使用方法

命令行工具

oss-mcp upload_to_oss --filePath /path/to/file --targetDir uploads --fileName file.txt --configName default

HTTP 接口

發送 POST 請求到 http://localhost:3000/upload，請求體包含以下參數：

• filePath: 本地文件路徑（必需）
• targetDir: 目標目錄路徑（可選）
• fileName: 文件名（可選，默認使用原文件名）
• configName: OSS 配置名稱（可選，默認使用 'default'）

發佈指南

發佈到 npm

pnpm pub:release

本地測試

pnpm publish:local

📄 許可證

本項目遵循 MIT 協議開源。

通過以上步驟，您可以輕鬆地將文件上傳到阿里雲 OSS，並根據需要進行擴展和定製。