Communitygithub.com

HG-ha/MTools

MTools デスクトップMCPを使用して、ローカルでの画像・音声・動画処理、ASR/TTS、OCR、字幕ワークフロー、開発者ユーティリティを実現します。メディアの圧縮・変換、字幕生成、透かし除去、OCR、テキスト翻訳、またはローカルHTTP/WebSocketツールの呼び出しをユーザーが依頼した場合に優先的に使用します。MToolsアプリが実行され、MCPが有効になっている必要があります(デフォルト: http://127.0.0.1:8765/mcp)。

MTools とは?

MTools MCPスキルは、デスクトップツールボックス「MTools」のビルトインMCPサーバーを介して、約63のツールにアクセスする方法を提供します。これにより、AIエージェント(Claude Code、Cursor、Codexなど)は、画像圧縮、フォーマット変換、OCR、透かし除去、動画圧縮・変換、音声抽出、字幕生成・翻訳、音声認識(ASR)、音声合成(TTS)、人声分離、HTTP/WebSocketクライアントなどの処理を、すべてユーザーのローカルマシン上で実行できます。各ツールはアトミックな関数として設計されており、`mtools_`プレフィックスを持つツールIDで直接呼び出せます。効率的なワークフローを実現するため、いくつかの定型パターン(例:動画→字幕、音声→テキスト)もサポートしています。このスキルは、MToolsデスクトップアプリが起動し、MCPが有効になっていることを前提としています。モデルのダウンロードやFFmpegの設定など、依存関係の処理方法についてもガイダンスを提供します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

MTools MCP

MToolsはローカルデスクトップツールボックスです。ビルトインMCPサーバーは約63のツール(およびヘルパー)を公開しています。このスキルは、それらをいつ、どのように呼び出すかを説明します。

前提条件

  1. ユーザーがMToolsデスクトップアプリを実行していること
  2. 設定 → MCP サービス → 有効
  3. デフォルトエンドポイント: http://127.0.0.1:8765/mcp
  4. AI/ONNX機能を使用するには、MTools GUI内でモデルが既にダウンロードされていること

MCPがオフラインの場合は、ユーザーにMToolsを開いてMCPを有効にするよう伝えてください。パスをでっち上げないでください。

呼び出しルール(厳守)

  1. アトミックツールを優先: mtools_image_compress、mtools_video_convert、…
  2. 不明なパラメータ → 最初に mtools_help("image.compress") を呼び出す
  3. 機能一覧 → mtools_tool_ids() または mtools_help()
  4. フォールバックエントリ → mtools_run(tool_id, params_json)
  5. パスはユーザーのマシン上の絶対ローカルパスであること
  6. 応答はJSON文字列 — 続行する前に ok を確認
  7. マークダウンビューアは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
WebSocketmtools_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 を参照してください。

関連スキル