Communitygithub.com

HG-ha/MTools

Nutze das MTools Desktop MCP zur lokalen Verarbeitung von Bildern, Audio, Video, ASR/TTS, OCR, Untertiteln und Entwicklerwerkzeugen. Bevorzugen, wenn der Benutzer nach Komprimierung/Konvertierung von Medien, Generierung von Untertiteln, Entfernung von Wasserzeichen, OCR von Bildern, Übersetzung von Texten oder dem Aufruf lokaler HTTP/WebSocket-Tools fragt. Erfordert die laufende MTools-App mit aktiviertem MCP (standardmäßig http://127.0.0.1:8765/mcp).

Was ist MTools?

MTools MCP ist eine lokale Desktop-Werkzeugkiste, die über ein integriertes MCP (Model Context Protocol) etwa 63 atomare Werkzeuge für Medien- und Entwicklungsaufgaben bereitstellt. Dieses Skill lehrt KI-Agenten, wann und wie diese Werkzeuge aufgerufen werden, um Aufgaben wie Bildkomprimierung, Videoformatumwandlung, Untertitelgenerierung, OCR, Audio-Transkription und WebSocket-Kommunikation effizient zu erledigen. Es unterstützt Plattformen wie Claude Code, Cursor und Codex, die MCP-basierte Tools nutzen. Die Werkzeuge werden als atomare Funktionen (z. B. `mtools_image_compress`) aufgerufen, wobei der lokale Pfad des Benutzers erforderlich ist und Antworten als JSON-Strings zurückgegeben werden. Workflows umfassen gängige Szenarien wie das Komprimieren von Fotos, das Erstellen von Untertiteln aus Videos, das Entfernen von Wasserzeichen und das Durchführen von WebSocket-Sitzungen. Fehlerbehandlungshinweise helfen bei typischen Problemen wie Verbindungsfehlern oder fehlenden Modellen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

MTools MCP

MTools ist eine lokale Desktop-Werkzeugkiste. Der integrierte MCP-Server stellt rund 63 Werkzeuge (plus Helfer) bereit. Dieses Skill lehrt, wann und wie sie aufgerufen werden.

Voraussetzungen

  1. Der Benutzer hat die MTools-Desktop-App laufen
  2. Einstellungen → MCP 服务 → aktiviert
  3. Standard-Endpunkt: http://127.0.0.1:8765/mcp
  4. AI/ONNX-Funktionen benötigen Modelle, die zuvor in der MTools-GUI heruntergeladen wurden

Wenn MCP offline ist: Den Benutzer auffordern, MTools zu öffnen und MCP zu aktivieren. Keine Pfade erfinden.

Aufrufregeln (streng)

  1. Bevorzuge atomare Werkzeuge: mtools_image_compress, mtools_video_convert, …
  2. Unbekannte Parameter → zuerst mtools_help("image.compress") aufrufen
  3. Fähigkeiten auflisten → mtools_tool_ids() oder mtools_help()
  4. Fallback-Einstieg → mtools_run(tool_id, params_json)
  5. Pfade müssen absolute lokale Pfade auf dem Rechner des Benutzers sein
  6. Antworten sind JSON-Strings — vor dem Fortfahren auf ok prüfen
  7. Der Markdown-Viewer wird nicht über MCP bereitgestellt

Schnellübersicht (Benutzerabsicht → Werkzeug)

Benutzer sagtAufruf
Bild komprimierenmtools_image_compress
Bild in jpg/png/webp konvertierenmtools_image_format
Bildfreistellung / Hintergrund entfernenmtools_image_background
OCR / Texterkennungmtools_image_ocr
Wasserzeichen aus Bild entfernenmtools_image_watermark_remove
Video komprimierenmtools_video_compress
Video formatierenmtools_video_convert
Audio aus Video extrahierenmtools_video_extract_audio
Untertitel aus Video entfernenmtools_video_subtitle_remove
Untertitel für Video generierenmtools_video_subtitle (mit target_lang/bilingual/burn_in)
TS-Segmente zusammenführenmtools_video_ts_merge
Audio in Text umwandelnmtools_audio_to_text
Text in Sprache umwandelnmtools_audio_text_to_speech
Stimme extrahierenmtools_audio_vocal_extraction / mtools_video_vocal_separation
Untertitelformate konvertierenmtools_subtitle_convert
KI-Untertitel verbessernmtools_ai_subtitle_fix
Übersetzenmtools_others_translate
Ausweis-/Portraitfotomtools_others_id_photo
HTTP-Anfragemtools_dev_http_client
WebSocketmtools_websocket (connect→send→receive→disconnect)
BildschirmaufnahmeNur GUI, MCP nicht verfügbar

Benennung: tool_id image.compress → atomares Werkzeug mtools_image_compress (mtools_ + Punkte → Unterstriche).

Arbeitsabläufe

A. Ein Foto komprimieren

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

B. Video → Untertitel (Zeitstempel / Übersetzung / Einbrennen)

mtools_video_subtitle(
  input_path="C:/a.mp4",
  language="de",
  target_lang="en",   # optionale Übersetzung
  bilingual=True,     # Original + Übersetzung
  burn_in=False       # True = ins Video einbrennen
)

Danach optional mit KI-Korrektur das Timing erhalten:

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

Erfordert, dass das SenseVoice/Whisper-Modell zuerst in MTools heruntergeladen wurde.

C. Audio → Text

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

Standard-Engine ist SenseVoice (50+ Sprachen) über sherpa-onnx.

D. Harte Untertitel / Wasserzeichen entfernen

Exakte Region bevorzugen:

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

Oder als Band: subtitle_region="bottom"|"top". Erfordert das Subtitle-Remove-Modell in MTools.

E. Video mit Steuerung komprimieren

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

F. WebSocket-Sitzung

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

Fehlerbehandlung

SymptomMaßnahme
Verbindung abgelehntBenutzer bitten, MTools zu starten und MCP zu aktivieren
ok: false + Modell nicht heruntergeladenBenutzer bitten, das Modell in der MTools-GUI herunterzuladen
Pfad nicht gefundenNach einem echten absoluten Pfad fragen
ffmpeg nicht verfügbarBenutzer bitten, FFmpeg in den MTools-Einstellungen zu konfigurieren

Gebote / Verbote

  • Tu rufe mtools_status einmal auf, wenn du unsicher bist, ob MCP gesund ist
  • Tu lasse output_path leer, wenn die automatische Ausgabe in Ordnung ist
  • Tu nicht API-Schlüssel aus mtools_ai_subtitle_fix preisgeben oder protokollieren
  • Tu nicht behaupten, dass Bildschirmaufnahme über MCP funktioniert
  • Tu nicht große veraltete Werkzeuge aufrufen (mtools_image mit action=…) — verwende Atome

MCP-Client-Konfiguration installieren

Siehe install.md für OpenClaw / Hermes / Cursor-Ausschnitte.

Verwandte Skills