How do I use MT Content Refactor MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MT Content Refactor MCP Server サイト1の記事をバックアップして、すべてのimgタグをfigureで囲むように変換して" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MT Content Refactor MCP Server

Movable Type の記事コンテンツを AI で一括変換するための MCP（Model Context Protocol）サーバーです。

Claude Desktop などの MCP 対応 AI クライアントから、MT Data API を通じて記事の HTML を一括で変換できます。

特徴

AI による柔軟な変換: 自然言語で変換ルールを指示するだけで、Claude が HTML を解析・変換
安全なワークフロー: バックアップ → 変換 → 差分確認 → 適用の段階的プロセス
差分レポート: 変更前後を比較できる HTML レポートを自動生成
ロールバック対応: いつでも元の状態に復元可能
セッション管理: 作業状態を保存し、後から再開可能

使用例

あなた: サイト1の記事をバックアップして

Claude: 45件の記事をバックアップしました。セッション: 20251208_150000

あなた: 以下のルールで変換して：
        - <p> 内に画像がある場合、<figure class="m-media"> で囲む
        - テキストのみの <p> には class="m-text" を追加

Claude: 12件に変更が必要です。変換を実行しました。

あなた: 差分レポートを見せて

Claude: 差分レポートを生成しました: ~/.config/mt-content-refactor/backups/20251208_150000/diff-report.html

あなた: 問題なさそうなので適用して

Claude: 12件の変更を MT に反映しました。

必要環境

Node.js 18 以上
Movable Type 6 以上（Data API v4 対応）
MCP 対応 AI クライアント（Claude Desktop など）

インストール

# リポジトリをクローン
git clone https://github.com/bit-part/mt-content-refactor-mcp.git
cd mt-content-refactor-mcp

# 依存関係をインストール
npm install

# ビルド
npm run build

Claude Desktop への登録

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加：

{
  "mcpServers": {
    "mt-content-refactor": {
      "command": "node",
      "args": ["/path/to/mt-content-refactor-mcp/dist/index.js"]
    }
  }
}

Volta を使用している場合は、Node.js のフルパスを指定：

{
  "mcpServers": {
    "mt-content-refactor": {
      "command": "/Users/yourname/.volta/bin/node",
      "args": ["/path/to/mt-content-refactor-mcp/dist/index.js"]
    }
  }
}

設定後、Claude Desktop を再起動してください。

使い方

1. 接続先の登録

MT環境を追加して
endpoint: https://example.com/mt/mt-data-api.cgi
username: api-user
password: secret123

2. 接続先の選択

MT環境に接続して

3. サイト・記事の確認

サイト一覧を表示して
サイト1の記事一覧を見せて

4. バックアップの作成

サイト1の記事を全件バックアップして

5. 変換の実行

以下のルールで変換して：
1. <p> 内に <img> がある場合、<figure> で囲む
2. テキストのみの <p> には class="m-text" を追加

6. 差分の確認

差分レポートを生成して

生成された HTML ファイルをブラウザで開いて確認します。

7. 変更の適用

変更を適用して

8. 問題があった場合のロールバック

記事ID 123 を元に戻して

利用可能なツール

接続管理

ツール	説明
`mt_list_connections`	登録済み接続先の一覧
`mt_add_connection`	新しい接続先を追加
`mt_use_connection`	使用する接続先を選択
`mt_remove_connection`	接続先を削除
`mt_test_connection`	接続テスト

コンテンツ操作

ツール	説明
`mt_list_sites`	サイト一覧
`mt_list_entries`	記事一覧
`mt_get_entry`	記事詳細取得
`mt_list_pages`	ページ一覧
`mt_get_page`	ページ詳細取得
`mt_list_content_types`	コンテンツタイプ一覧
`mt_list_content_data`	コンテンツデータ一覧
`mt_get_content_data`	コンテンツデータ詳細取得

バックアップ・変換

ツール	説明
`mt_create_backup`	バックアップセッション作成
`mt_get_backup_items`	バックアップ内容取得
`mt_set_transform`	単一アイテムの変換結果を設定
`mt_set_bulk_transform`	複数アイテムの変換結果を一括設定
`mt_generate_diff_report`	差分レポート生成
`mt_apply_changes`	変更を MT に適用
`mt_restore`	ロールバック
`mt_list_sessions`	セッション一覧
`mt_load_session`	セッション読み込み
`mt_delete_session`	セッション削除

データの保存場所

バックアップデータは以下に保存されます：

~/.config/mt-content-refactor/
├── connections.json          # 接続先情報
└── backups/
    └── 20251208_150000/      # セッションディレクトリ
        ├── session.json      # セッション情報
        ├── items/            # 各アイテムのバックアップ
        │   ├── entry_123.json
        │   └── entry_124.json
        └── diff-report.html  # 差分レポート

開発

# 開発モード（ファイル変更を監視）
npm run dev

# MCP Inspector で動作確認
npm run inspect

注意事項

本番環境での使用は慎重に: 必ずテスト環境で動作確認してから使用してください
バックアップの確認: 変更適用前に必ず差分レポートを確認してください
認証情報の管理: 接続情報は ~/.config/mt-content-refactor/connections.json に保存されます

ライセンス

MIT License

作者

mersy

MT Content Refactor MCP Server

MT Content Refactor MCP Server

特徴

使用例

必要環境

インストール

Claude Desktop への登録

使い方

1. 接続先の登録

2. 接続先の選択

3. サイト・記事の確認

4. バックアップの作成

5. 変換の実行

6. 差分の確認

7. 変更の適用

8. 問題があった場合のロールバック

利用可能なツール

接続管理

コンテンツ操作

バックアップ・変換

データの保存場所

開発

注意事項

ライセンス

作者

関連リンク

Resources

Tools

Latest Blog Posts

MCP directory API