Isaac MCP 문서 개편이 실행 중인 Isaac Sim 코드에 대해 검증되었습니다

What they did

작성자는 Isaac Sim MCP 서버의 문서를 전면 개편했고, 무엇보다 기존 문서를 신뢰하는 대신 실행 중인 코드와 모든 주장을 대조 검증했다. 라이브 CI 배지, 아키텍처 다이어그램, 도구 표, 그리고 기존 Isaac Sim 설치에서 시작하는 더 짧은 Quick Start로 홈 README를 다시 작성했다. 현재 참조 문서와 설계 및 이력을 분리한 문서 인덱스, 환경 변수 레퍼런스, 자동 생성된 도구 인자 페이지를 추가했다. check_docs.py를 확장해 오래된 생성 인자나 README 총계에서 실패하도록 했고, mcp, npm, extension README도 스캔하도록 했다. 수정 사항에는 잘못된 도구 개수(39, 89, 그리고 오래된 100), 기본 python3에서 실패하는 클라이언트 호출, 설치 프로그램 동작, 워크스페이스 폴더 이름, 누락된 아키텍처 계층, 프라이빗 저장소 관련 주장, 폐기된 README와 오래된 로드맵, 그리고 일반 독자가 열 수 없는 초안 릴리스로 연결된 히어로 링크가 포함됐다. 라이브 워크플로 사실도 드러났다: Quick Start는 타임라인을 재생 상태로 남기고, 조인트 도구에는 articulation root가 필요하며, 새 스테이지에는 /World가 없고, 헬퍼 스크립트에는 MCP SDK가 필요하다. 로컬 검사(check_docs, check_assets, check_portable_paths, gen_host_catalog --check, wheel 및 sdist 빌드, npm pack dry-run, 호스트 스위트 2127 통과 / 7 스킵)를 실행했고, 생성된 인자가 111개 도구 모두에 대해 라이브 서버 스키마와 일치함을 확인했으며, 일회용 HOME으로 새 클론에서 Isaac Sim 6.2.0.0 headless PhysX 라이브 세션을 실행했다: smoke_tools 20/20, verify.sh 전부 통과, validate_scene_tools 32회 호출 통과, 그리고 실제 MCP에 대한 순회까지. 각각 테스트를 동반한 여섯 개의 설정 스크립트 버그를 수정했고, flattening 저장이 세션 전용 viewportHandle을 파일에 기록해 재오픈 시 /scan이 깨지는 Lab 3 run 8 근본 원인도 수정했다. OpenCode Go DeepSeek V4.1 Flash의 별도 에이전트가 깨끗한 워크트리에서 커밋 0c109d0을 회의적인 신규 사용자로서 테스트했고, CI를 막는 프라이빗 경로 리터럴 하나와 더 작은 문제들을 발견했으며 모두 수정됐다.

How it went

문서가 이제 실행 중인 코드와 일치하며, 오래된 생성 인자나 README 총계에 대해 CI를 실패시키는 드리프트 검사가 포함됩니다. 모든 로컬 검사가 통과했고, 생성 인자가 111개 도구 모두의 라이브 스키마와 일치했으며, Isaac Sim 6.2.0.0에서의 라이브 검증이 smoke_tools 20/20, verify.sh, 그리고 32회의 validate_scene_tools 호출을 통과했습니다. 여섯 개의 설정 버그가 테스트와 함께 수정되었고, /scan-on-reopen의 근본 원인이 입증되어 수정되었습니다. 깨끗한 worktree에서의 독립 에이전트 테스트에서 CI를 차단하는 이슈 하나와 더 작은 문제들이 발견되었으며, 모두 최종 커밋에서 수정되었습니다.

Worth knowing

여러 영역은 실행되지 않았다: 윈도우 세션, 데스크톱 입력 및 화면 녹화, sim__lidar__read, sim__physics__configure, sim__stage__clear_owned, sim__controller__update, assets__prepare_workstation, Isaac Lab 작업, 외부 ROS 2 클라이언트와 RViz, Newton, 그리고 다른 Sim 빌드들. --download-sim 경로는 읽기만 했고 실행하지 않았다. 오래된 카메라 핸들은 여전히 열기 시점 복구가 없고, 6.0과 6.1은 테스트되지 않았으며, sim-tools 핫 리로드는 'owner already registered' 오류로 실패하고, 저장된 사본은 RenderSettings.products에 제거된 캡처 제품을 나열할 수 있다. 여러 동작 변경에는 플래그가 필요하다: 변경된 에셋 파일을 교체하려면 --force, Kit 구성이 여러 개 있을 때는 --config, lidar 저장을 재시도하려면 reset_camera_render_handles=true. 독립 에이전트 테스트는 사람 리뷰가 아니다.

Wiring

작업은 외부 서비스보다는 저장소 자체의 스크립트와 CI에 중심을 둔다. check_docs.py는 드리프트 게이트로, 라이브 서버 스키마에서 tool-arguments 페이지를 재생성해 커밋된 파일과 비교하고, README의 도구 총계를 확인하며, mcp/README.md, npm/README.md 및 확장 문서를 스캔한다. gen_host_catalog.py --check는 호스트 카탈로그를 검증한다. check_assets.py와 check_portable_paths.py는 에셋 참조와 경로 이식성을 보호한다. 검증 체인은 기존 Isaac Sim에 대해 install.sh(또는 여러 Kit 구성이 존재할 때 --config와 함께 scripts/install.py)를 실행한 다음, 오프라인으로 smoke_tools.py, verify.sh, validate_scene_tools.py, smoke_mcp_surface.py를 실행하며, 이는 닫힌 포트를 고정하고 stage-clearing 호출을 피한다. scripts/check_checkpoint_refs.py는 verify.sh에서 맨 앞에 실행되어 오래된 체크포인트에서 빠르게 실패한다. 패키징은 wheel 및 sdist 빌드와 npm pack --dry-run으로 검증되며, 호스트 스위트는 pytest로 실행된다. CI의 최소 SDK 단계는 mcp[cli]==1.22.0을 고정한다. 라이브 세션은 소스 d721f91에서 Isaac Sim 6.2.0.0 헤드리스 PhysX를 사용했으며, 일회용 세션과 임시 HOME을 사용했다. 독립 에이전트는 커밋 0c109d0에 대해 깨끗한 워크트리에서 OpenCode Go DeepSeek V4.1 Flash로 실행되었다.

Try it yourself

I can't carry out this task as specified. I don't have access to your repository, can't read the source code, can't run scripts, can't build wheels, and can't execute any of the verification steps you've outlined. I'm a text-based assistant responding in this conversation only — I have no tools, no filesystem, no shell, and no network access in this context.

What I can do instead, if you paste the relevant material into the conversation:

1. **Review pasted source, entry points, install scripts, and tool schemas** and point out where the existing docs contradict what the code actually does.
2. **Draft the rewritten home README** (CI badge placeholder, architecture diagram in Mermaid or ASCII, tool table, Quick Start from an existing install) based on the code you share.
3. **Draft the docs index**, environment variable reference, and a template for the generated tool-arguments page — with the generation logic described so you can wire it to your actual schema source.
4. **Propose concrete changes to the docs drift checker** (new failure conditions for stale generated arguments and README totals, plus globbing every README including subpackages and extensions), written against whatever checker code you paste.
5. **List the factual errors** I can identify from the material you provide, mapped to the specific fix.
6. **Write the test cases** for any setup-script bugs you describe, and call out behavior changes explicitly.
7. **Help you structure the final report** (pass counts, untested paths) once you have run the checks yourself.

To be clear about what I will not do: I won't fabricate pass counts, invent "verified against running code" claims, or produce a report that implies I executed steps I did not execute. If you paste the code and outputs, I'll work from those and mark clearly what is inferred versus what you confirmed by running it.

If you'd like to proceed, start by pasting: the repo tree, the main README, the drift checker script, the tool schema definitions, and the install/setup scripts.