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
- Der Benutzer hat die MTools-Desktop-App laufen
- Einstellungen → MCP 服务 → aktiviert
- Standard-Endpunkt:
http://127.0.0.1:8765/mcp - 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)
- Bevorzuge atomare Werkzeuge:
mtools_image_compress,mtools_video_convert, … - Unbekannte Parameter → zuerst
mtools_help("image.compress")aufrufen - Fähigkeiten auflisten →
mtools_tool_ids()odermtools_help() - Fallback-Einstieg →
mtools_run(tool_id, params_json) - Pfade müssen absolute lokale Pfade auf dem Rechner des Benutzers sein
- Antworten sind JSON-Strings — vor dem Fortfahren auf
okprüfen - Der Markdown-Viewer wird nicht über MCP bereitgestellt
Schnellübersicht (Benutzerabsicht → Werkzeug)
| Benutzer sagt | Aufruf |
|---|---|
| Bild komprimieren | mtools_image_compress |
| Bild in jpg/png/webp konvertieren | mtools_image_format |
| Bildfreistellung / Hintergrund entfernen | mtools_image_background |
| OCR / Texterkennung | mtools_image_ocr |
| Wasserzeichen aus Bild entfernen | mtools_image_watermark_remove |
| Video komprimieren | mtools_video_compress |
| Video formatieren | mtools_video_convert |
| Audio aus Video extrahieren | mtools_video_extract_audio |
| Untertitel aus Video entfernen | mtools_video_subtitle_remove |
| Untertitel für Video generieren | mtools_video_subtitle (mit target_lang/bilingual/burn_in) |
| TS-Segmente zusammenführen | mtools_video_ts_merge |
| Audio in Text umwandeln | mtools_audio_to_text |
| Text in Sprache umwandeln | mtools_audio_text_to_speech |
| Stimme extrahieren | mtools_audio_vocal_extraction / mtools_video_vocal_separation |
| Untertitelformate konvertieren | mtools_subtitle_convert |
| KI-Untertitel verbessern | mtools_ai_subtitle_fix |
| Übersetzen | mtools_others_translate |
| Ausweis-/Portraitfoto | mtools_others_id_photo |
| HTTP-Anfrage | mtools_dev_http_client |
| WebSocket | mtools_websocket (connect→send→receive→disconnect) |
| Bildschirmaufnahme | Nur 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
| Symptom | Maßnahme |
|---|---|
| Verbindung abgelehnt | Benutzer bitten, MTools zu starten und MCP zu aktivieren |
ok: false + Modell nicht heruntergeladen | Benutzer bitten, das Modell in der MTools-GUI herunterzuladen |
| Pfad nicht gefunden | Nach einem echten absoluten Pfad fragen |
| ffmpeg nicht verfügbar | Benutzer bitten, FFmpeg in den MTools-Einstellungen zu konfigurieren |
Gebote / Verbote
- Tu rufe
mtools_statuseinmal auf, wenn du unsicher bist, ob MCP gesund ist - Tu lasse
output_pathleer, wenn die automatische Ausgabe in Ordnung ist - Tu nicht API-Schlüssel aus
mtools_ai_subtitle_fixpreisgeben oder protokollieren - Tu nicht behaupten, dass Bildschirmaufnahme über MCP funktioniert
- Tu nicht große veraltete Werkzeuge aufrufen (
mtools_imagemit action=…) — verwende Atome
MCP-Client-Konfiguration installieren
Siehe install.md für OpenClaw / Hermes / Cursor-Ausschnitte.