Skip to main content
Glama
Sign In

OSS MCP Server

by 1yhy
GitHub
TypeScript
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

OSS MCP 服务器 🚀

中文版 | English

一个基于Model Context Protocol (MCP)的服务器，用于将文件上传到阿里云OSS。此服务器使大型语言模型能够直接将文件上传到阿里云对象存储服务。

💡 使用场景

OSS MCP服务器能够与其他MCP工具无缝集成，为您提供强大的工作流程：

  • 与Playwright MCP集成：可以先使用Playwright MCP抓取网页截图或下载网页资源，然后直接上传到阿里云OSS存储。
  • 与Figma MCP集成：下载图片资源到本地后直接上传OSS、或者Figma网络文件直接上传OSS。
  • 与Filesystem MCP集成：可以浏览和选择本地文件系统中的文件，然后一步上传到云存储。
  • 数据备份流程：将重要数据从本地或其他服务自动备份到OSS。
  • 媒体处理流程：结合其他处理工具，可以对图片、视频进行处理后直接上传并获取可访问的URL。
  • 多OSS账号管理：便捷地在多个OSS账号间切换上传目标。

✨ 功能特点

  • 📁 支持多个阿里云OSS配置
  • 🗂️ 可指定上传目录
  • 🔄 简单易用的接口

🔧 安装

您可以通过npm或从源码安装：

使用npm安装

# 使用npm全局安装 npm install -g oss-mcp # 或使用pnpm全局安装 pnpm add -g oss-mcp

使用示例

# 直接启动 (stdio模式) oss-mcp --oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}' # 使用Inspector调试 oss-mcp --oss-config='{ "region": "oss-cn-shenzhen", "accessKeyId": "YOUR_KEY", "accessKeySecret": "YOUR_SECRET", "bucket": "BUCKET_NAME", "endpoint": "oss-cn-shenzhen.aliyuncs.com" }' --inspect

从源码安装

# 克隆仓库 git clone https://github.com/1yhy/oss-mcp.git cd oss-mcp # 安装依赖 pnpm install # 构建项目 pnpm build

⚙️ 配置

您可以通过以下方式配置阿里云OSS参数：

方式一：使用.env文件

在项目根目录创建.env文件，参考.env.example模板。您可以配置多个阿里云OSS服务：

# 默认OSS配置 OSS_CONFIG_DEFAULT={"region":"oss-cn-hangzhou","accessKeyId":"your-access-key-id","accessKeySecret":"your-access-key-secret","bucket":"your-bucket-name","endpoint":"oss-cn-hangzhou.aliyuncs.com"} # 其他OSS配置 OSS_CONFIG_TEST={"region":"oss-cn-beijing","accessKeyId":"your-access-key-id-2","accessKeySecret":"your-access-key-secret-2","bucket":"your-bucket-name-2","endpoint":"oss-cn-beijing.aliyuncs.com"}

方式二：直接设置环境变量

您也可以直接在系统中或启动命令中设置环境变量：

# 设置环境变量并启动 pnpm dev --oss-config='{ "default": { "region": "oss-cn-shenzhen", "accessKeyId": "YOUR_KEY", "accessKeySecret": "YOUR_SECRET", "bucket": "BUCKET_NAME", "endpoint": "oss-cn-shenzhen.aliyuncs.com" }, "test": { "region": "oss-cn-beijing", "accessKeyId": "YOUR_KEY", "accessKeySecret": "YOUR_SECRET", "bucket": "BUCKET_NAME", "endpoint": "oss-cn-beijing.aliyuncs.com" } }'

🔍 参数说明

  • region: 阿里云OSS区域
  • accessKeyId: 阿里云访问密钥ID
  • accessKeySecret: 阿里云访问密钥Secret
  • bucket: OSS存储桶名称
  • endpoint: OSS终端节点

📋 使用方法

命令行选项

选项: -s, --stdio 使用stdio传输启动服务器 -h, --http 使用HTTP传输启动服务器 -p, --port HTTP服务器端口 (默认: 3000) -i, --inspect 使用Inspector工具启动 -?, --help 显示帮助信息

从源码启动

# 开发模式 pnpm dev # 启动服务 (stdio模式) pnpm start # 启动HTTP服务 pnpm start:http # 使用Inspector调试 pnpm inspect

🛠️ 与Claude/Cursor配置集成

Cursor配置方法

  1. 在Cursor中打开设置（Settings）
  2. 转到MCP服务器（MCP Servers）部分
  3. 添加新服务器配置：
{ "mcpServers": { "oss-mcp": { "command": "npx", "args": [ "oss-mcp", "--oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}'", "--stdio" ] } } }

配置多个OSS账号

使用环境变量方式可以轻松配置多个OSS账号：

{ "mcpServers": { "oss-mcp": { "command": "npx", "args": [ "oss-mcp", "--oss-config='{\"default\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}, \"test\":{\"region\":\"oss-cn-shenzhen\",\"accessKeyId\":\"YOUR_KEY\",\"accessKeySecret\":\"YOUR_SECRET\",\"bucket\":\"YOUR_BUCKET\",\"endpoint\":\"oss-cn-shenzhen.aliyuncs.com\"}}'", "--stdio" ] } } }

🧰 可用工具

服务器提供以下工具：

1. 上传文件到OSS (upload_to_oss)

参数:

  • filePath: 本地文件路径（必需）
  • targetDir: 目标目录路径（可选）
  • fileName: 文件名（可选，默认使用原文件名）
  • configName: OSS配置名称（可选，默认使用'default'）

2. 列出可用的OSS配置 (list_oss_configs)

无参数，返回所有可用的OSS配置名称。

📦 发布

# 发布到npm pnpm pub:release # 本地打包测试 pnpm publish:local

📊 Star History

📄 许可证

MIT

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables large language models to upload files directly to Alibaba Cloud Object Storage Service (OSS), supporting multiple OSS configurations and specified upload directories.

  1. 💡 使用场景
    1. ✨ 功能特点
      1. 🔧 安装
        1. 使用npm安装
        2. 使用示例
        3. 从源码安装
      2. ⚙️ 配置
        1. 方式一：使用.env文件
        2. 方式二：直接设置环境变量
      3. 🔍 参数说明
        1. 📋 使用方法
          1. 命令行选项
          2. 从源码启动
        2. 🛠️ 与Claude/Cursor配置集成
          1. Cursor配置方法
          2. 配置多个OSS账号
        3. 🧰 可用工具
          1. 上传文件到OSS (upload_to_oss)
          2. 列出可用的OSS配置 (list_oss_configs)
        4. 📦 发布
          1. 📊 Star History
            1. 📄 许可证

              Related MCP Servers

              • Filesystem MCP Server

                bsmi021
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
                Last updated -
                1
                TypeScript
                MIT License

              • File Operations MCP Server

                bsmi021
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.
                Last updated -
                12
                6
                TypeScript
                MIT License

              • MCP Database Server

                dwarvesf
                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that provides tools for interacting with databases, including PostgreSQL, DuckDB, and Google Cloud Storage Parquet files.
                Last updated -
                2
                TypeScript
                • Linux
                • Apple

              • cloudinary-mcp-server

                yoavniran
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that exposes Cloudinary Upload & Admin API methods as tools by AI assistants. This integration allows AI systems to trigger and interact with your Cloudinary cloud.
                Last updated -
                5
                506
                JavaScript
                MIT License

              View all related MCP servers

              New MCP Servers

              ID: eyw0458h83