Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

[Feature Request] Add 3 missing tools: image_to_image / play_video / upload_file

Abierto
#22 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
typescript

Línea de trabajo

Comienza localizando la herramienta existente play_audio y el registro de herramientas MCP o los puntos de entrada en minimax-mcp-js. Verifica las APIs de edición de imágenes y carga de archivos de MiniMax antes de definir sus entradas y salidas, y compara el enfoque de reproducción específico de cada plataforma con el helper de audio existente. Se considera terminado cuando las tres herramientas están expuestas con un comportamiento documentado y cobertura para sus entradas y plataformas compatibles.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Background

The official MiniMax API already supports the following capabilities, but minimax-mcp-js v0.0.17 does not expose them as MCP tools:

  • Image-to-Image (/v1/image/editing or similar endpoint) — transform an existing image with a text prompt + reference image(s)
  • Video playback — local playback helper for downloaded .mp4 files (currently play_audio says "Does not support video")
  • File upload — local file upload helper, useful as input for voice_clone, image_to_video, etc.

Why it matters

These are listed in multiple third-party / community docs (CSDN service docs, ModelScope MCP page) as part of the official MiniMax MCP feature set, so users expect them. Without them:

  1. Users on Claude Code / Cursor / Windsurf cannot do iterative image editing (must use external tools)
  2. Users cannot preview generated videos locally — they have to switch to Finder/Quick Look after every generate_video / image_to_video call
  3. Users have to manually upload reference files to a CDN before calling image_to_video or voice_clone

Proposed tools

1. image_to_image
  • Inputs: image_1 (reference), optional image_2..5, optional subject_image_*
  • Arguments: prompt (required), aspect_ratio, imageCount
  • Maps to: MiniMax /v1/image/editing or similar
2. play_video
  • Inputs: path (local .mp4 path)
  • Uses macOS open / Linux xdg-open / Windows start to launch the system default player (same pattern as play_audio but for video)
3. upload_file
  • Inputs: path (local file path), optional purpose (string, e.g. voice_clone, image_ref)
  • Returns: hosted URL usable as input to other tools

Request

Please consider adding these three tools in the next minor release (v0.0.18+). Happy to submit a PR if maintainers agree on the API surface — just point me at the right branch / contribution guide.


Repo cross-references that mention these tools but link to the older Python MiniMax-MCP repo:

Lenguaje dominante
TypeScript
Estrellas
130
Forks
43
Métricas de merge de PR
Sin PR fusionados en 30 d

Preparar el entorno

  • Incluye un Dockerfile o un archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de MiniMax-AI/MiniMax-MCP-JS

Todos los issues de MiniMax-AI/MiniMax-MCP-JS

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.