AI Disk Doctor 통합

AI Disk Doctor Core용 범용 로컬 Agent Skill 및 읽기 전용 MCP 서버입니다.

이 저장소는 통합 및 배포 계층입니다. 두 번째 스캐너, 클리너, 리스크 엔진, 복구 모델 또는 정책 시스템을 구현하지 않습니다. 로컬 Core가 실행 및 정책의 근원(source of truth)으로 유지됩니다.

Alpha 범위

MCP 서버는 네 가지 도구를 제공합니다:

I0는 clean, restore, quarantine, delete, 임의 셸 또는 임의 파일 시스템 변경 도구를 제공하지 않습니다. explain_storage는 병합된 M1C Explainability Contract가 공개 Core에서 제공될 때까지 의도적으로 포함되지 않습니다.

설치

사전 요구 사항

• Node.js 18 이상.

• PATH에 aidisk/aidisk.exe로 제공되는 AI Disk Doctor Core v1.7.0 또는 호환되는 이후 Core 버전.

• 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이 아니며 계정, 결제, 자격(entitlements), 원격 측정, 클라우드 동기화 또는 독점 Desktop 코드를 포함하지 않습니다.