OSS MCP Server

Um servidor local para upload de arquivos para o Alibaba Cloud Object Storage Service (OSS).

Documentação

Servidor OSS MCP 🚀

Versão em chinês | English

oss-mcp

Um servidor baseado no Model Context Protocol (MCP) para enviar arquivos para o Alibaba Cloud OSS. Este servidor permite que modelos de linguagem de grande porte enviem arquivos diretamente para o serviço de armazenamento de objetos do Alibaba Cloud.

💡 Casos de uso

O servidor OSS MCP pode ser integrado perfeitamente com outras ferramentas MCP, fornecendo fluxos de trabalho poderosos:

Integração com Playwright MCP: Você pode usar o Playwright MCP para capturar capturas de tela de páginas da web ou baixar recursos da web e, em seguida, enviá-los diretamente para o armazenamento OSS do Alibaba Cloud.
Integração com Figma MCP: Baixe recursos de imagem localmente e envie diretamente para o OSS, ou envie arquivos de rede do Figma diretamente para o OSS.
Integração com Filesystem MCP: Você pode navegar e selecionar arquivos no sistema de arquivos local e, em seguida, enviá-los para o armazenamento em nuvem em uma única etapa.
Fluxo de backup de dados: Faça backup automático de dados importantes do local ou de outros serviços para o OSS.
Fluxo de processamento de mídia: Combine com outras ferramentas de processamento para processar imagens e vídeos e, em seguida, enviá-los diretamente e obter URLs acessíveis.
Gerenciamento de múltiplas contas OSS: Alterne convenientemente entre vários destinos de upload em diferentes contas OSS.

✨ Recursos

📁 Suporte a múltiplas configurações do Alibaba Cloud OSS
🗂️ Diretório de upload especificável
🔄 Interface simples e fácil de usar

🔧 Instalação

Você pode instalar via npm ou a partir do código-fonte:

Instalação via npm

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

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

Exemplo 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

Instalação a partir do código-fonte

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

# 安装依赖
pnpm install

# 构建项目
pnpm build

⚙️ Configuração

Você pode configurar os parâmetros do Alibaba Cloud OSS das seguintes maneiras:

Método 1: Usando o arquivo .env

Crie um arquivo .env na raiz do projeto, consulte o modelo .env.example. Você pode configurar vários serviços do 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: Definir variáveis de ambiente diretamente

Você também pode definir variáveis de ambiente diretamente no sistema ou no comando de inicialização:

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

🔍 Descrição dos parâmetros

region: Região do Alibaba Cloud OSS
accessKeyId: ID da chave de acesso do Alibaba Cloud
accessKeySecret: Segredo da chave de acesso do Alibaba Cloud
bucket: Nome do bucket OSS
endpoint: Endpoint do OSS

📋 Como usar

Opções de linha de comando

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

Inicialização a partir do código-fonte

# 开发模式
pnpm dev

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

# 启动HTTP服务
pnpm start:http

# 使用Inspector调试
pnpm inspect

🛠️ Integração com configuração do Claude/Cursor

Método de configuração do Cursor

Abra as configurações (Settings) no Cursor
Vá para a seção de servidores MCP (MCP Servers)
Adicione uma nova configuração 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"
      ]
    }
  }
}

Configurando múltiplas contas OSS

Usando variáveis de ambiente, você pode configurar facilmente várias contas 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"
      ]
    }
  }
}

🧰 Ferramentas disponíveis

O servidor fornece as seguintes ferramentas:

1. Enviar arquivo para o OSS (`upload_to_oss`)

Parâmetros:

filePath: Caminho do arquivo local (obrigatório)
targetDir: Caminho do diretório de destino (opcional)
fileName: Nome do arquivo (opcional, usa o nome original por padrão)
configName: Nome da configuração OSS (opcional, usa 'default' por padrão)

2. Listar configurações OSS disponíveis (`list_oss_configs`)

Sem parâmetros, retorna todos os nomes de configuração OSS disponíveis.

📦 Publicação

# 发布到npm
pnpm pub:release

# 本地打包测试
pnpm publish:local

📊 Histórico de estrelas

📄 Licença

MIT