AI Disk Doctor Integrations

AI Disk Doctor Core 用のユニバーサルなローカル Agent Skill および読み取り専用 MCP サーバーです。

このリポジトリは統合・配布レイヤーです。2 つ目のスキャナー、クリーナー、リスクエンジン、リカバリモデル、ポリシーシステムを実装するものではありません。ローカル Core が実行とポリシーの唯一の情報源であり続けます。

Alpha スコープ

MCP サーバーは 4 つのツールを公開します:

I0 は clean、restore、quarantine、delete、任意のシェル、任意のファイルシステム変更ツールを公開しません。explain_storage は、統合された M1C Explainability コントラクトが公開 Core で利用可能になるまで意図的に含まれていません。

インストール

前提条件

• Node.js 18 以降。

• AI Disk Doctor Core v1.7.0 または互換性のあるそれ以降の Core が PATH 上に aidisk/aidisk.exe として存在すること。

• Core バイナリが別の場所にインストールされている場合は AIDISK_EXE を設定します。

チェックアウトからインストール:

git clone https://github.com/quzhiii/ai-disk-doctor-integrations.git
cd ai-disk-doctor-integrations
npm install
npm start

決定論的なローカルインストールの場合は、リポジトリのチェックアウトを固定するか、タグ付きリリースを使用します。npm 依存関係は package-lock.json 内で @modelcontextprotocol/sdk 1.30.0 に固定されています。

このプロセスは MCP stdio トランスポートを使用し、スタンドアロンの対話型プログラムとしてではなく、MCP クライアントによって起動される必要があります。

OpenCode

OpenCode は opencode.json または opencode.jsonc 内のプロジェクトローカル MCP 宣言をサポートしています:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-disk-doctor": {
      "type": "local",
      "command": ["node", "C:/absolute/path/to/ai-disk-doctor-integrations/src/server.js"],
      "cwd": "C:/absolute/path/to/your-workspace",
      "enabled": true
    }
  }
}

グローバルインストールの場合は、command 引数に絶対パスを使用し、必要に応じて environment に AIDISK_EXE を設定します。cwd は統合チェックアウトではなく、Core スナップショットを保存するユーザーワークスペースに設定します。次に opencode mcp list を使用するか、エージェントに core_status の確認を依頼します。チェックイン済みの例は adapters/opencode/opencode.jsonc にあります。

OpenCode Agent Skills は .opencode/skills、.claude/skills、または .agents/skills から検出されます。プロジェクトまたはユーザーインストールのために、skills/ai-disk-doctor をこれらの場所のいずれかにコピーまたはシンボリックリンクします。

Qwen Code

Qwen Code は qwen mcp または settings.json を通じてローカル stdio MCP サーバーをサポートしています:

qwen mcp add --scope user --transport stdio ai-disk-doctor node ./src/server.js

同等の .qwen/settings.json エントリ:

{
  "mcpServers": {
    "ai-disk-doctor": {
      "command": "node",
      "args": ["/absolute/path/to/ai-disk-doctor-integrations/src/server.js"],
      "cwd": "/absolute/path/to/your-workspace",
      "env": { "AIDISK_EXE": "aidisk" },
      "trust": false
    }
  }
}

リポジトリルートは、その qwen-extension.json を通じて Qwen 拡張パッケージです。npm install の後にリポジトリをローカル拡張としてインストールします。adapters/qwen/README.md を参照してください。正規の Skill は同じ Skill のままであり、Qwen 固有のガバナンス実装ではありません。

CodeBuddy / WorkBuddy

インストールされた製品がサポートするローカル MCP 設定サーフェスを使用し、同じ node ./src/server.js stdio プロセスを指定します。その作業ディレクトリを、Core スナップショット履歴が置かれるワークスペースに設定します。Expert ペルソナやベンダー固有のリスクロジックは含まれていません。正確なパッケージングは、公式でローカルテスト可能な CodeBuddy / WorkBuddy クライアントコントラクトが利用可能になるまで延期されます。adapters/codebuddy/README.md を参照してください。

TRAE

TRAE の文書化されたプロジェクト MCP 設定を使用し、同じローカル stdio プロセスを追加します。その作業ディレクトリを、Core スナップショット履歴が置かれるワークスペースに設定します。正確なプロジェクトパッケージングは、検証用に TRAE クライアントがローカルで利用可能になるまで延期されます。adapters/trae/README.md を参照してください。

Core 診断

# Verify the Core directly
aidisk --help

# Verify the integration server syntax
npm run check

# Override the Core executable
# Windows PowerShell:
$env:AIDISK_EXE = 'C:\\Tools\\aidisk.exe'
# POSIX shells:
export AIDISK_EXE=/opt/aidisk

Core が存在しないか、不正または非互換な出力を返す場合、core_status は構造化された失敗を報告します。MCP プロセスは Core をダウンロードしたり、リポジトリをクローンしたり、クラウドサービスに接続したり、別のスキャナーを黙って代用したりしません。

安全性の境界

• MCP トランスポートはローカル stdio のみです。

• サーバーは、設定された aidisk 実行可能ファイルを固定された読み取り指向のサブコマンドでのみ起動します。

• 任意のシェルや任意のコマンドツールは存在しません。

• クリーンアップ、隔離実行、復元、削除、変更ツールは存在しません。

• scan_summary は、現在の Core スキャン永続化が AI Disk Doctor 所有のスナップショットを書き込む可能性があるため、readOnlyHint: false とマークされています。それでも destructiveHint: false であり、ユーザー/ワークスペースファイルを変更しません。

• モデルインベントリは Core コントラクトに従ってメタデータのみです。この統合は、プロンプト、トランスクリプト、ソース、ドキュメント、トークン、クッキー、認証情報の内容を読み取りません。

• ツールに指定されたパスは、対応する Core コマンドまたは履歴メタデータリーダーにのみ渡されます。この統合によって再帰的に読み取られることはありません。

エージェントは、シェルコマンドでパスを削除することによってこれらのルールを迂回してはなりません。将来の変更フローが承認された場合、それは別の認可サーフェスを使用する必要があります。

開発

npm install
npm run check
npm test

実際の Core スモークテストを行うには、固定された Core リビジョンをインストール/ビルドし、aidisk を PATH に置くか AIDISK_EXE を設定し、npm test を実行します。実 Core テストは AIDISK_EXE が設定されていない場合はスキップされます。残りのプロトコルテストは一時ディレクトリと Core 欠落ケースを使用します。ベンダークライアントがインストールされているふりはしません。

ライセンス

統合ソースは MIT または Apache-2.0 のデュアルライセンスです。LICENSE-MIT と LICENSE-APACHE を参照してください。Core のライセンスは公開 Core リポジトリによって管理され続けます。

ステータス

I0 Alpha。このリポジトリは商用 Desktop ではなく、アカウント、請求、エンタイトルメント、テレメトリ、クラウド同期、または独自の Desktop コードを含みません。