optiflow-mcp

하나의 Claude Code 플러그인, 하나의 MCP 서버, 하나의 저장소 — 별도로 설치된 도구를 감싸는 래퍼가 아닙니다. 두 개의 상위 프로젝트의 실제 소스를 자체 코드베이스로 진정으로 병합합니다:

1. token-optimizer-mcp 의 76개의 실제 smart_*/analytics/dashboard-monitoring MCP 도구와 PreToolUse/PreCompact 시행 훅을 src/optimizer/로 직접 포팅했습니다 — npx 설치나 별도 프로세스가 필요 없습니다.

2. headroom 의 실제 Rust 압축 코어(SmartCrusher)를 native/headroom-core/로 포크하고 기능을 축소한 후 실제 WebAssembly(native/headroom-wasm/)로 컴파일하여 Node 플러그인에서 직접 로드합니다 — 재작성이 아닌 진정한 Rust 알고리즘입니다. headroom의 CodeCompressor 및 Kompress ML 모델은 대신 TypeScript로 네이티브 재구현되었습니다(src/native/).

3. 두 상위 도구가 다루지 않은 자체 모듈 5개: chop 스타일 Bash/CLI 출력 차단, 세션 보고서 대본 분석, 상태 표시줄 컨텍스트 미터, /optiflow:compact-continue 세션 핸드오프 체크포인트, 대용량 JSON/CSV/YAML 페이로드용 TOON 변환.

두 상위 프로젝트는 여전히 출처/라이선스 텍스트를 위해 vendor/ 아래에 git 서브모듈로 참조되지만, src/나 native/ 아래의 어떤 것도 vendor/에서 가져오지 않습니다. 원래 오케스트레이션 래퍼 설계(v1)를 이 방식으로 대체한 이유는 docs/ADR/0002-real-merge-not-orchestration.md를 참조하고, 전체 권한 맵과 고정된 결정 사항은 docs/architecture.md를 참조하세요.

상태

두 주요 병합이 완료되어 연결되었습니다: token-optimizer-mcp의 76개 도구 + 시행 훅 병합, 그리고 headroom의 압축 코어(WASM SmartCrusher

• TS CodeCompressor/Kompress)가 격리된 상태로만 빌드된 것이 아니라 출시된 파이프라인에서 실제로 호출됩니다. npm run build, npm test, npx tsc --noEmit 모두 통과합니다 — 각 모듈의 세부 사항과 현재 테스트 수는 docs/modules.md를 참조하세요. 소스에서 빌드하려면 Node 외에도 Rust 툴체인(rustup, wasm32-unknown-unknown 타겟, wasm-pack)이 필요합니다. 플러그인 설치 시에는 필요하지 않습니다(컴파일된 .wasm은 plugin/dist/와 같은 이유로 커밋되어 있습니다).

Related MCP server: claude-engineering-coach

시작하기

github.com/kristijankopacevic/optiflow-mcp에 게시되어 있습니다. 로컬 경로 마켓플레이스를 통해 end-to-end로 검증되었습니다(이를 위해 gh 인증은 필요 없습니다):

1. Claude Code 세션에서 이 저장소를 마켓플레이스로 추가하고 플러그인을 설치하세요:

   /plugin marketplace add C:\path\to\optiflow-mcp
   /plugin install optiflow@optiflow

2. 환경을 확인하세요:

   optiflow doctor

   Node/npm 버전, 설정 해석, gh 존재 여부/인증을 보고합니다.

3. 상태 표시줄을 활성화하세요(선택 사항, 옵트인 — 플러그인만 설치해도 settings.json을 변경하지 않습니다):

   optiflow install --statusline

   쓰기 전에 ~/.claude/settings.json을 백업하고, 원자적으로 쓰며, --force 없이 기존의 다른 상태 표시줄을 덮어쓰지 않습니다. optiflow uninstall이 이를 되돌립니다. 자세한 내용(수동 설정 포함)은 docs/statusline-manual-setup.md를, 나머지 모듈은 docs/modules.md를 참조하세요.

이 빠른 시작 이상의 아키텍처, 설정, 모듈별 참조는 docs/를 참조하세요.

라이선스

optiflow-mcp 자체 코드는 MIT 라이선스입니다(LICENSE 참조). 이 저장소는 MIT 라이선스(token-optimizer-mcp) 및 Apache-2.0 라이선스(headroom) 상위 프로젝트의 소스도 복사하여 포함합니다 — THIRD_PARTY_LICENSES.md 및 NOTICE를 참조하세요.