OSS MCP Server

Un servidor local para subir archivos al Servicio de Almacenamiento de Objetos (OSS) de Alibaba Cloud.

Documentación

Servidor OSS MCP 🚀

Versión en chino | English

oss-mcp

Un servidor basado en el Protocolo de Contexto de Modelos (MCP) para cargar archivos a Alibaba Cloud OSS. Este servidor permite que los modelos de lenguaje grandes carguen archivos directamente al servicio de almacenamiento de objetos de Alibaba Cloud.

💡 Casos de uso

El servidor OSS MCP puede integrarse sin problemas con otras herramientas MCP para brindarle flujos de trabajo potentes:

Integración con Playwright MCP: puede usar Playwright MCP para capturar capturas de pantalla de páginas web o descargar recursos web, y luego cargarlos directamente al almacenamiento OSS de Alibaba Cloud.
Integración con Figma MCP: descargue recursos de imagen localmente y luego cárguelos directamente a OSS, o cargue archivos web de Figma directamente a OSS.
Integración con Filesystem MCP: puede explorar y seleccionar archivos en el sistema de archivos local y luego cargarlos a la nube en un solo paso.
Flujo de respaldo de datos: respalde automáticamente datos importantes desde el local u otros servicios a OSS.
Flujo de procesamiento de medios: combine con otras herramientas de procesamiento para procesar imágenes y videos, luego cárguelos directamente y obtenga URL accesibles.
Gestión de múltiples cuentas OSS: cambie convenientemente entre múltiples cuentas OSS para los destinos de carga.

✨ Características

📁 Soporta múltiples configuraciones de Alibaba Cloud OSS
🗂️ Puede especificar el directorio de carga
🔄 Interfaz simple y fácil de usar

🔧 Instalación

Puede instalar a través de npm o desde el código fuente:

Instalar con npm

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

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

Ejemplo de uso

# 直接启动 (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

Instalar desde el código fuente

# 克隆仓库
git clone https://github.com/1yhy/oss-mcp.git
cd oss-mcp

# 安装依赖
pnpm install

# 构建项目
pnpm build

⚙️ Configuración

Puede configurar los parámetros de Alibaba Cloud OSS de las siguientes maneras:

Método 1: Usar el archivo .env

Cree el archivo .env en el directorio raíz del proyecto, consulte la plantilla .env.example. Puede configurar múltiples servicios de Alibaba Cloud 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"}

Método 2: Configurar variables de entorno directamente

También puede configurar variables de entorno directamente en el sistema o en el comando de inicio:

# 设置环境变量并启动
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" } }'

🔍 Descripción de parámetros

region: Región de Alibaba Cloud OSS
accessKeyId: ID de clave de acceso de Alibaba Cloud
accessKeySecret: Secreto de clave de acceso de Alibaba Cloud
bucket: Nombre del bucket OSS
endpoint: Punto de conexión de OSS

📋 Método de uso

Opciones de línea de comandos

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

Iniciar desde el código fuente

# 开发模式
pnpm dev

# 启动服务 (stdio模式)
pnpm start

# 启动HTTP服务
pnpm start:http

# 使用Inspector调试
pnpm inspect

🛠️ Integración con la configuración de Claude/Cursor

Método de configuración de Cursor

Abra la configuración (Settings) en Cursor
Vaya a la sección de servidores MCP (MCP Servers)
Agregue una nueva configuración de servidor:

{
  "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"
      ]
    }
  }
}

Configurar múltiples cuentas OSS

Usando variables de entorno puede configurar fácilmente múltiples cuentas 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"
      ]
    }
  }
}

🧰 Herramientas disponibles

El servidor proporciona las siguientes herramientas:

1. Cargar archivo a OSS (`upload_to_oss`)

Parámetros:

filePath: Ruta del archivo local (obligatorio)
targetDir: Ruta del directorio de destino (opcional)
fileName: Nombre del archivo (opcional, por defecto usa el nombre original)
configName: Nombre de la configuración OSS (opcional, por defecto usa 'default')

2. Listar configuraciones OSS disponibles (`list_oss_configs`)

Sin parámetros, devuelve los nombres de todas las configuraciones OSS disponibles.

📦 Publicación

# 发布到npm
pnpm pub:release

# 本地打包测试
pnpm publish:local

📊 Historial de estrellas

📄 Licencia

MIT