Metadata-Version: 2.4
Name: mcp-minimax
Version: 2026.8.7.2
Summary: MCP server for MiniMax H3 multimodal video generation via AceDataCloud
Project-URL: Homepage, https://github.com/AceDataCloud/MinimaxMCP
Project-URL: Documentation, https://platform.acedata.cloud
Project-URL: Repository, https://github.com/AceDataCloud/MinimaxMCP
Project-URL: Issues, https://github.com/AceDataCloud/MinimaxMCP/issues
Project-URL: Changelog, https://github.com/AceDataCloud/MinimaxMCP/blob/main/CHANGELOG.md
Author-email: AceDataCloud <support@acedata.cloud>
Maintainer-email: AceDataCloud <support@acedata.cloud>
License: MIT
License-File: LICENSE
Keywords: acedata,ai,claude,generation,llm,mcp,minimax,minimax-h3,model-context-protocol,video
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: loguru>=0.7.0
Requires-Dist: mcp<2,>=1.2.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: all
Requires-Dist: build>=1.2.0; extra == 'all'
Requires-Dist: mypy>=1.10.0; extra == 'all'
Requires-Dist: pre-commit>=3.7.0; extra == 'all'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'all'
Requires-Dist: pytest-cov>=5.0.0; extra == 'all'
Requires-Dist: pytest>=8.0.0; extra == 'all'
Requires-Dist: respx>=0.21.0; extra == 'all'
Requires-Dist: ruff>=0.4.0; extra == 'all'
Requires-Dist: twine>=5.0.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Provides-Extra: release
Requires-Dist: build>=1.2.0; extra == 'release'
Requires-Dist: twine>=5.0.0; extra == 'release'
Provides-Extra: test
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Requires-Dist: respx>=0.21.0; extra == 'test'
Description-Content-Type: text/markdown

# MiniMax H3 MCP

<!-- mcp-name: io.github.AceDataCloud/mcp-minimax -->

[![PyPI](https://img.shields.io/pypi/v/mcp-minimax.svg)](https://pypi.org/project/mcp-minimax/)
[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)

Model Context Protocol server for MiniMax H3 multimodal video generation through AceDataCloud.

## Capabilities

- Text-to-video
- Image-to-video with 1–9 reference images
- Audio-guided video with 1–3 audio references and required images
- 4–15 second output in 768P or 2K, with 16:9 or 9:16
- Asynchronous single and batch task retrieval
- Hosted OAuth HTTP transport and local stdio transport

## Tools

| Tool | Purpose |
| --- | --- |
| `minimax_generate_video_from_text` | Generate from a detailed prompt |
| `minimax_generate_video_from_images` | Generate from one to nine image URLs |
| `minimax_generate_video_from_audio` | Generate with one to three audio URLs and required images |
| `minimax_get_task` | Retrieve one task |
| `minimax_get_tasks_batch` | Retrieve several tasks |
| `minimax_list_models` | Show model constraints |
| `minimax_list_actions` | Show available workflows |

## Hosted server

```text
https://minimax.mcp.acedata.cloud/mcp
```

The hosted server supports AceDataCloud OAuth. MCP clients that support remote OAuth can connect directly to this URL.

Public API reference: [MiniMax H3 Videos API](https://platform.acedata.cloud/documents/minimax-videos).

## Local installation

```bash
pipx install mcp-minimax
export ACEDATACLOUD_API_TOKEN="YOUR_API_TOKEN"
mcp-minimax
```

Get a token from [AceDataCloud](https://platform.acedata.cloud/console/applications).

### Claude Code

```bash
claude mcp add minimax --transport stdio \
  --env ACEDATACLOUD_API_TOKEN=YOUR_API_TOKEN \
  -- mcp-minimax
```

### Generic MCP configuration

```json
{
  "mcpServers": {
    "minimax": {
      "command": "mcp-minimax",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
```

## Examples

Text:

```text
Generate a 6-second 16:9 video: a red fox running through a snowy forest at dawn, low tracking shot.
```

Images:

```text
Animate these two reference images for 8 seconds while preserving the character and clothing.
```

Audio:

```text
Create a 9:16 dance video guided by this audio, with cuts and motion following the beat.
```

Generation tools submit asynchronously. Poll the returned task ID with `minimax_get_task` until the final AceDataCloud CDN video is available.

## Development

```bash
pip install -e ".[dev,test]"
ruff check .
pytest --cov=core --cov=tools
mypy core tools
```

## License

MIT
