MCP-CLEAN

MCP-CLEAN は、このマシン上で承認されたプロジェクトフォルダを管理するためのローカルコントロールセンターです。

MCP-CLEAN のアーキテクチャ

• server.mjs - MCP サーバーとツールの実装

• config/allowed-roots.json - 許可されたプロジェクトルート

• backups/ - プロジェクトのアーカイブとファイルバックアップ

• logs/ - 運用ログ

• logs/actions.log - アクション監査証跡

• temp/ - 一時ランタイムファイル

• exchange/ - 交換メタデータとプロジェクトノート

• smoke-test.mjs - ローカルスモークテスト

Related MCP server: Local File Management MCP Server

利用可能なすべてのツール

• ping

• list_directory

• read_file

• write_file

• project_status

• backup_project

• health_check

• git_status_all

• git_checkpoint

• restore_project

• system_status

• project_scan

• safe_change

プロジェクトの操作

• すべての操作は config/allowed-roots.json のパスに制限されています。

• system_status と git_status_all は、許可されたプロジェクトのみに対して動作します。

• project_scan は、ファイルを変更せずに構造の深いチェックを実行します。

• safe_change は、バックアップと checkpoint を介してプロジェクトを準備します。

Backup

• すべてのアーカイブとファイルバックアップは F:\MCP-CLEAN\backups にのみ保存されます。

• アーカイブ名にはタイムスタンプが含まれます。

• backup の結果には、パス、サイズ、プロジェクト情報、アーカイブのリストが含まれます。

Git checkpoint

• git_checkpoint は origin main への stage、commit、push を実行します。

• 変更なしの安全な確認のための dryRun がサポートされています。

Rollback

• restore_project は、commit が指定されていない場合、利用可能な checkpoint commit を表示します。

• ロールバックの前にバックアップが作成されます。

• その後、選択した commit に対して git reset --hard が実行されます。

ログ

• logs/mcp-clean.log - 運用レコード。

• logs/actions.log - 日付、ツール、プロジェクト、アクション、結果を含むアクションジャーナル。

作業フロー

1. health_check でヘルス状態を確認します。

2. system_status でシステムを確認します。

3. project_scan でプロジェクトを分析します。

4. safe_change で変更を準備します。

5. 必要に応じて git_checkpoint で checkpoint を作成します。

6. 必要に応じて restore_project でプロジェクトをロールバックします。