TensorsLab MCP Server

A Model Context Protocol (MCP) server that provides tools for generating AI images and videos using the TensorsLab API.

Features

Image Generation Tools

• generate_image_v45 - SeeDream V4.5 (highest quality, recommended)
• generate_image_v4 - SeeDream V4 (faster generation)
• check_image_task_status - Check image generation status
• delete_image_tasks - Delete image tasks

Video Generation Tools

• generate_video_v2 - SeeDance V2 (latest, up to 15s, 1440p)
• generate_video_v15pro - SeeDance V1.5 Pro (high quality)
• generate_video_fast - SeeDance V1 Fast (quick previews)
• check_video_task_status - Check video generation status
• delete_video_tasks - Delete video tasks

Installation

1. Install Dependencies

cd mcp/tensorslab-mcp-server
npm install

2. Build the Project

npm run build

Configuration

Getting Your API Key

1. Visit https://test.tensorai.tensorslab.com/
2. Sign up or log in
3. Navigate to API settings
4. Copy your API key

Claude Desktop Configuration

Add the following to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tensorslab": {
      "command": "node",
      "args": ["tensorslab-mcp-server/dist/index.js"],
      "env": {
        "TENSORSLAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Important: Replace your-api-key-here with your actual TensorsLab API key and update the path if needed.

Usage

Image Generation

// Generate an image with SeeDream V4.5
await generate_image_v45({
  prompt: "A beautiful sunset over mountains",
  batchSize: 2,
  resolution: "16:9"
})

Video Generation

// Generate a video with SeeDance V2
await generate_video_v2({
  prompt: "A drone flying over a forest",
  ratio: "16:9",
  duration: 10,
  resolution: "1080p"
})

Tool Parameters Reference

Image Generation (SeeDream V4.5)

Video Generation (SeeDance V2)

Development

Run in Development Mode

npm run dev

Run with MCP Inspector

npm run inspector

Build for Production

npm run build
npm start

Project Structure

tensorslab-mcp-server/
├── src/
│   ├── index.ts      # Main MCP server with tool registrations
│   ├── api.ts        # TensorsLab API client
│   └── types.ts      # TypeScript type definitions
├── dist/             # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

Troubleshooting

"TENSORSLAB_API_KEY environment variable is required"

• Make sure you set the API key in your Claude Desktop config or environment

"Insufficient credits"

• Top up your balance at https://test.tensorai.tensorslab.com/

Task timeout

• Large videos may take longer. Use check_video_task_status to poll manually
• Image tasks timeout after 3 minutes, video tasks after 5 minutes

Module not found errors

• Run npm install to ensure all dependencies are installed
• Run npm run build to compile TypeScript

API Reference

For complete API documentation, see:

• Image API Reference
• Video API Reference

License

MIT