MTools MCP
MToolsはローカルデスクトップツールボックスです。ビルトインMCPサーバーは約63のツール(およびヘルパー)を公開しています。このスキルは、それらをいつ、どのように呼び出すかを説明します。
前提条件
- ユーザーがMToolsデスクトップアプリを実行していること
- 設定 → MCP サービス → 有効
- デフォルトエンドポイント:
http://127.0.0.1:8765/mcp - AI/ONNX機能を使用するには、MTools GUI内でモデルが既にダウンロードされていること
MCPがオフラインの場合は、ユーザーにMToolsを開いてMCPを有効にするよう伝えてください。パスをでっち上げないでください。
呼び出しルール(厳守)
- アトミックツールを優先:
mtools_image_compress、mtools_video_convert、… - 不明なパラメータ → 最初に
mtools_help("image.compress")を呼び出す - 機能一覧 →
mtools_tool_ids()またはmtools_help() - フォールバックエントリ →
mtools_run(tool_id, params_json) - パスはユーザーのマシン上の絶対ローカルパスであること
- 応答はJSON文字列 — 続行する前に
okを確認 - マークダウンビューアはMCP経由では公開されていません
クイックマップ(ユーザーの意図 → ツール)
| ユーザーが言う | 呼び出すツール |
|---|---|
| 圧縮画像 | mtools_image_compress |
| 画像を jpg/png/webp に変換 | mtools_image_format |
| 切り抜き / 背景除去 | mtools_image_background |
| OCR / 文字認識 | mtools_image_ocr |
| 画像の透かし除去 | mtools_image_watermark_remove |
| 動画圧縮 | mtools_video_compress |
| 動画フォーマット変換 | mtools_video_convert |
| 動画から音声抽出 | mtools_video_extract_audio |
| 動画の字幕除去 | mtools_video_subtitle_remove |
| 動画字幕生成 | mtools_video_subtitle(target_lang/bilingual/burn_in可能) |
| TS チャンク結合 | mtools_video_ts_merge |
| 音声をテキストに変換 | mtools_audio_to_text |
| テキストを音声に変換 | mtools_audio_text_to_speech |
| 人声分離 | mtools_audio_vocal_extraction / mtools_video_vocal_separation |
| 字幕フォーマット相互変換 | mtools_subtitle_convert |
| AI字幕修正 | mtools_ai_subtitle_fix |
| 翻訳 | mtools_others_translate |
| 証明写真 | mtools_others_id_photo |
| HTTPリクエスト | mtools_dev_http_client |
| WebSocket | mtools_websocket(接続→送信→受信→切断) |
| 画面録画 | GUIのみ、MCPでは利用不可 |
命名規則: tool_id image.compress → アトミックツール mtools_image_compress
(mtools_ + ドットをアンダースコアに変換)。
ワークフロー
A. 写真を圧縮
mtools_image_compress(
input_path="C:/photos/a.jpg",
quality="high", # high|medium|low
compress_mode_name="balanced" # fast|balanced|max
)
B. 動画 → 字幕(タイムスタンプ/翻訳/焼き込み)
mtools_video_subtitle(
input_path="C:/a.mp4",
language="zh",
target_lang="en", # オプション: 翻訳
bilingual=True, # 原文 + 翻訳
burn_in=False # True = 動画に焼き込み
)
その後、AI修正でタイミングを調整(オプション):
mtools_ai_subtitle_fix(
segments_json='[{"text":"...","start":0,"end":1.2}, ...]',
base_url=..., api_key=..., model=...
)
先にSenseVoice/WhisperモデルをMToolsにダウンロードする必要があります。
C. 音声 → テキスト
mtools_audio_to_text(input_path="C:/a.mp3", language="zh")
デフォルトエンジンはSenseVoice(50以上の言語対応、sherpa-onnx経由)。
D. ハードサブ/透かしを除去
正確な領域を指定するのがおすすめ:
mtools_video_subtitle_remove(
input_path="C:/a.mp4",
left=0, top=800, right=1920, bottom=1080
)
またはバンド指定: subtitle_region="bottom"|"top"。MToolsに字幕除去モデルが必要です。
E. 動画を細かく指定して圧縮
mtools_video_compress(input_path="C:/a.mp4", scale="720p", crf=23, fps=30)
F. WebSocket セッション
1. mtools_websocket(action="connect", url="ws://127.0.0.1:8080")
→ 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=...)
エラーハンドリング
| 症状 | 対処方法 |
|---|---|
| 接続拒否 | ユーザーにMToolsを起動し、MCPを有効にするよう依頼 |
ok: false + モデル未ダウンロード | MTools GUIでモデルをダウンロードするよう依頼 |
| パスが見つからない | 実際の絶対パスを確認するよう依頼 |
| ffmpegが利用不可 | MTools設定でFFmpegを設定するよう依頼 |
推奨事項 / 禁止事項
- 推奨: MCPが正常かどうか不明な場合は、
mtools_statusを一度呼び出す - 推奨: 自動出力で問題ない場合は、
output_pathを空のままにする - 禁止:
mtools_ai_subtitle_fixのAPIキーを公開またはログに記録する - 禁止: MCP経由で画面録画が機能すると主張する
- 禁止: レガシーな巨大ツール(
mtools_imageで action=…)を呼び出す — アトミックツールを使用
MCPクライアント設定のインストール
OpenClaw / Hermes / Cursorのスニペットについては install.md を参照してください。