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)

Parameter	Type	Required	Description
prompt	string	Yes	Text description of the image
batchSize	number	No	1-15 images (default: 1)
resolution	string	No	9:16, 16:9, 3:4, 4:3, 1:1, 2:3, 3:2, 2K, 4K, or WxH
imageUrl	string	No	Source image URL for image-to-image
seed	number	No	Random seed for reproducibility
promptExtend	boolean	No	Enable prompt enhancement (default: true)

Video Generation (SeeDance V2)

Parameter	Type	Required	Description
prompt	string	Yes	Text description of the video
ratio	string	No	9:16 (vertical) or 16:9 (horizontal)
duration	number	No	5-15 seconds (default: 5)
resolution	string	No	480p, 720p, 1080p, or 1440p
fps	string	No	Frame rate (default: 24)
imageUrl	string	No	Source image URL for image-to-video
generateAudio	boolean	No	Generate audio (default: false)
returnLastFrame	boolean	No	Return last frame as image
seed	number	No	Random seed for reproducibility

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