OSS MCP HTTP Tool

Overview

• Provides a simple HTTP endpoint to upload files to Aliyun OSS using ali-oss.
• Designed to be usable as an MCP tool via HTTP transport (command = server URL).

Endpoints

• GET /health → status and bucket info.
• GET /config → safe subset of config (bucket, endpoint, cdn).
• POST /upload → body: { filePath: string, objectPath?: string } returns { success, url, objectName }.

Setup

1. Ensure Node.js 18+ is installed.
2. Copy .env (already included) or set environment variables:
   • OSS_ACCESS_KEY_ID
   • OSS_ACCESS_KEY_SECRET
   • OSS_BUCKET
   • OSS_ENDPOINT
   • OSS_CDN_URL (optional but recommended for public URLs)
3. Install dependencies: npm install in oss-mcp/.
4. Start server: npm start.

Test

• Run npm run test:upload with server running. It uploads oss-mcp/sample.txt to mcp/uploads/sample-<timestamp>.txt and prints the URL.

MCP Integration (HTTP transport)

• In your MCP tool registry, set:
  • transport: http
  • command: http://localhost:3333 (adjust PORT as needed)
  • enabledTools: include a descriptor for upload endpoint if your registry requires.
  • Optionally pass env with OSS_* entries (already in .env).

Doubao Model Note

• Your LLM selection (Doubao doubao:doubao-seedream-4-0-250828) and DOUBAO_API_KEY are configured at the client/IDE level.
• This server does not call the model; it only exposes an HTTP tool the LLM can invoke.
• Set your IDE to use Doubao and register this HTTP tool; then instruct the model to call /upload with { filePath, objectPath }.

Security

• Do not commit .env with production secrets in shared repos.
• Prefer using dev/public endpoints (non-internal) for local testing.

CLI (MCP stdio)

• This package provides a CLI josn that runs a Model Context Protocol stdio server exposing an upload tool.
• Install globally: npm i -g josn
• Claude Desktop config example (Windows %APPDATA%\Claude\claude_desktop_config.json): { "mcpServers": { "oss-aliyun-stdio": { "command": "josn", "args": [], "env": { "OSS_ACCESS_KEY_ID": "optional-override", "OSS_ACCESS_KEY_SECRET": "optional-override", "OSS_BUCKET": "optional-override", "OSS_ENDPOINT": "optional-override", "OSS_CDN_URL": "optional-override" } } } }
• Keys are embedded with safe defaults for personal use; you can override via env.

Publish to npm

1. Ensure you have an npm account and are logged in: npm login
2. From project root oss-mcp/, publish: npm publish
3. Update version in package.json when republishing.

Usage in Claude

• After publishing, install globally: npm i -g josn (or use npx josn)
• In Claude, add the MCP server config above and restart Claude Desktop.