Communitygithub.com

HG-ha/MTools

Utilisez le MCP de bureau MTools pour le traitement local d'images, audio, vidéo, ASR/TTS, OCR, workflows de sous-titres et utilitaires de développement. Privilégiez-le lorsque l'utilisateur demande de compresser/convertir des médias, générer des sous-titres, supprimer des filigranes, faire de l'OCR, traduire du texte ou appeler des outils HTTP/WebSocket locaux. Nécessite que l'application MTools soit en cours d'exécution avec MCP activé (http://127.0.0.1:8765/mcp par défaut).

Qu'est-ce que MTools ?

MTools est une boîte à outils de bureau locale qui expose un serveur MCP (Model Context Protocol) intégré, offrant environ 63 outils atomiques pour le traitement de médias, les sous-titres, la traduction et les utilitaires de développement. Ce skill guide un agent IA (comme Claude Code ou Cursor) sur la manière et le moment d'appeler ces outils via le point de terminaison MCP par défaut, en privilégiant les outils atomiques plutôt que les anciens outils 'fat legacy'. Il permet des opérations telles que la compression d'images, la conversion de formats vidéo, l'extraction de texte par OCR, la génération de sous-titres avec traduction bilingue, la synthèse vocale, et même des sessions WebSocket. Cependant, il nécessite que l'application MTools soit en cours d'exécution sur la machine de l'utilisateur et que les modèles AI pertinents (SenseVoice, Whisper, etc.) soient téléchargés via l'interface graphique de MTools. Le skill détaille des workflows concrets pour des cas d'usage courants, des règles strictes d'appel (chemins absolus, vérification des réponses JSON, utilisation de `mtools_help` pour les paramètres inconnus) et la gestion des erreurs.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/HG-ha/MTools/tree/HEAD/skills/mtools

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

MTools MCP

MTools est une boîte à outils de bureau locale. Son serveur MCP intégré expose environ 63 outils (plus des aides). Ce skill enseigne quand et comment les appeler.

Prérequis

  1. L'utilisateur a l'application de bureau MTools en cours d'exécution
  2. Paramètres → MCP 服务 → activé
  3. Point de terminaison par défaut : http://127.0.0.1:8765/mcp
  4. Les fonctionnalités AI/ONNX nécessitent que les modèles soient déjà téléchargés via l'interface graphique de MTools

Si MCP est hors ligne : demandez à l'utilisateur d'ouvrir MTools et d'activer MCP. N'inventez pas de chemins.

Règles d'appel (strictes)

  1. Préférez les outils atomiques : mtools_image_compress, mtools_video_convert, …
  2. Paramètres inconnus → appelez mtools_help("image.compress") d'abord
  3. Liste des capacités → mtools_tool_ids() ou mtools_help()
  4. Entrée de repli → mtools_run(tool_id, params_json)
  5. Les chemins doivent être des chemins locaux absolus sur la machine de l'utilisateur
  6. Les réponses sont des chaînes JSON — vérifiez ok avant de continuer
  7. La visionneuse Markdown n'est pas exposée via MCP

Mappage rapide (intention utilisateur → outil)

L'utilisateur ditAppelez
Compresser une imagemtools_image_compress
Convertir une image en jpg/png/webpmtools_image_format
Détourer / Supprimer l'arrière-planmtools_image_background
OCR / Lire du textemtools_image_ocr
Supprimer un filigrane d'imagemtools_image_watermark_remove
Compresser une vidéomtools_video_compress
Convertir un format vidéomtools_video_convert
Extraire l'audio d'une vidéomtools_video_extract_audio
Supprimer les sous-titres d'une vidéomtools_video_subtitle_remove
Générer des sous-titres pour une vidéomtools_video_subtitle (avec target_lang/bilingual/burn_in possibles)
Fusionner des segments TSmtools_video_ts_merge
Transcrire l'audio en textemtools_audio_to_text
Synthèse vocale (texte en parole)mtools_audio_text_to_speech
Séparation des voixmtools_audio_vocal_extraction / mtools_video_vocal_separation
Convertir un format de sous-titresmtools_subtitle_convert
Améliorer des sous-titres par IAmtools_ai_subtitle_fix
Traduiremtools_others_translate
Photo d'identitémtools_others_id_photo
Requête HTTPmtools_dev_http_client
WebSocketmtools_websocket (connecter→envoyer→recevoir→déconnecter)
Capture d'écranUniquement via GUI, MCP non disponible

Nommage : tool_id image.compress → outil atomique mtools_image_compress (mtools_ + points → underscores).

Workflows

A. Compresser une photo

mtools_image_compress(
  input_path="C:/photos/a.jpg",
  quality="high",          # high|medium|low
  compress_mode_name="balanced"  # fast|balanced|max
)

B. Vidéo → sous-titres (horodatage / traduction / incrustation)

mtools_video_subtitle(
  input_path="C:/a.mp4",
  language="zh",
  target_lang="en",   # traduction optionnelle
  bilingual=True,     # original + traduction
  burn_in=False       # True = incruster dans la vidéo
)

Ensuite, préservez éventuellement le timing avec une correction IA :

mtools_ai_subtitle_fix(
  segments_json='[{"text":"...","start":0,"end":1.2}, ...]',
  base_url=..., api_key=..., model=...
)

Nécessite un modèle SenseVoice/Whisper téléchargé dans MTools au préalable.

C. Audio → texte

mtools_audio_to_text(input_path="C:/a.mp3", language="zh")

Le moteur par défaut est SenseVoice (50+ langues) via sherpa-onnx.

D. Supprimer des sous-titres incrustés / filigranes

Préférez une région exacte :

mtools_video_subtitle_remove(
  input_path="C:/a.mp4",
  left=0, top=800, right=1920, bottom=1080
)

Ou une bande : subtitle_region="bottom"|"top". Nécessite un modèle de suppression de sous-titres dans MTools.

E. Compresser une vidéo avec contrôle

mtools_video_compress(input_path="C:/a.mp4", scale="720p", crf=23, fps=30)

F. Session WebSocket

1. mtools_websocket(action="connect", url="ws://127.0.0.1:8080")
   → sauvegarder session_id
2. mtools_websocket(action="send", session_id=..., message="ping")
3. mtools_websocket(action="receive", session_id=...)
4. mtools_websocket(action="disconnect", session_id=...)

Gestion des erreurs

SymptômeQue faire
Connexion refuséeDemander à l'utilisateur de démarrer MTools et d'activer MCP
ok: false + modèle non téléchargéDemander à l'utilisateur de télécharger le modèle dans l'interface graphique de MTools
Chemin introuvableDemander un chemin absolu réel
ffmpeg indisponibleDemander à l'utilisateur de configurer FFmpeg dans les paramètres de MTools

À faire / À ne pas faire

  • Faites appeler mtools_status une fois si vous n'êtes pas sûr que MCP est opérationnel
  • Faites laisser output_path vide si une sortie automatique est acceptable
  • Ne faites pas exposer ou journaliser les clés API provenant de mtools_ai_subtitle_fix
  • Ne faites pas prétendre que l'enregistrement d'écran fonctionne via MCP
  • N'appelez pas les anciens outils "fat legacy" (mtools_image avec action=…) — utilisez les outils atomiques

Installer la configuration client MCP

Voir install.md pour des extraits pour OpenClaw / Hermes / Cursor.

Skills associés