OSS MCP 服务器

OSS MCP 服务器是一个基于 Model Context Protocol (MCP) 的工具，用于将文件上传到阿里云的 Object Storage Service (OSS)。它支持通过命令行界面或 HTTP 协议启动，并提供多种功能来简化文件管理。

使用场景

• 数据存储：将本地文件高效地上传到阿里云 OSS，适合需要长期存储和管理大数据量的应用。
• 自动化工作流：集成到 CI/CD 流水线或其他自动化工具中，自动处理和上传文件。
• 团队协作：在团队项目中共享文件存储，确保所有成员都能方便地访问和管理资源。

功能特点

• 支持通过标准输入输出 (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，并根据需要进行扩展和定制。