WLKATA MT4 control stack의 개요
GitHub 사용자 enghoff의 이 프로젝트는 4축 탁상 로봇 팔 WLKATA MT4의 소프트웨어를 처음부터 끝까지 교체합니다. 팔의 ATmega2560 컨트롤러에 직교 좌표 이동과 경로 대기열을 지원하는 새 펌웨어를 기록하고, 인쇄한 ArUco 마커를 팔의 좌표에 대응시키는 고정 USB 카메라를 더하며, 17개의 MCP 도구를 제공합니다. 클라이언트는 이를 통해 팔을 원점으로 보내고, 책상을 살피고, cube_2나 marker_1처럼 id로 부르는 물체를 집거나 놓을 수 있습니다.
Python 3.10+용으 로 작성됐고 Windows에서 동작합니다. 선택 사항인 GPU 서비스로 이름으로 물체를 찾는 Grounding DINO, 윤곽을 따는 SAM 2.1, 입력한 지시를 다루는 Qwen3-VL-4B를 더할 수 있습니다. 저장소의 스타는 1개, 커밋은 7월부터 2026년 8월 15일까지이며 라이선스 파일은 없습니다. 팔 자체는 RobotShop에서 교육용 키트로 $1,380입니다.
WLKATA MT4 control stack 설치 방법
pip install -r requirements.txt && python flash_jog.py --port COM6 && python -m mt4_mcp --stdioWLKATA MT4 control stack, 쓸 만한 가치가 있습니까?
MT4 스택은 특정한 팔 하나를 위한 본격적인 엔지니어링입니다. 책상 위의 모든 것은 엔티티 id로 다루며, 팔이 무언가를 집거나 놓을 수 없을 때 도구가 이유를 알려 줍니다. 닿지 않음, 받침 주변 진입 금지 구역 안, 집게 손가락이 들어갈 공간 부족, 책상 밖 같은 식입니다. 가장 비슷한 물체로 대신하는 기능은 일부러 없습니다. 엉뚱한 물체를 집었다는 사실을 시스템의 어느 부분도 알아챌 수 없기 때문입니다. 물리적인 기계를 맡은 에이전트에게는 옳은 설계입니다.
이 서버는 집게가 달린 전동 팔을 움직입니다. 펌웨어는 받침 주변에 140 mm 진입 금지 원기둥, 관절 소프트 한계, 책상 바닥면을 적용하지만, README에 따르면 관절 공간 이동과 원점 복귀는 이 검사를 거치지 않습니다. 보정은 코드만큼 중요합니다. 스크립트 다섯 개가 카메라와 책상을 대응시키는데, 받침 보정을 새로 한 뒤 나머지를 이어서 하지 않으면 큐브 집기는 조용히 15~30 mm의 오차로 돌아가고 책상 가장자리 검사도 가장자 리 밖으로 놓는 동작을 더는 거부하지 않습니다. J4 손목의 영점은 전원을 끌 때마다 사라집니다.
주의할 점: 네트워크와 라이선스입니다. 기본적으로 MCP 서버는 127.0.0.1:8787에서 대기하거나 stdio로 동작합니다. ChatGPT 등 원격 클라이언트용 공개 모드는 Host 헤더 보호를 끄고 ngrok 터널, Google 로그인과 함께 씁니다. auth.py를 읽어 보면 어떤 Google 계정이 로그인할 수 있는지 제한하는 설정이 없으므로, 공개 터널은 그 로그인을 마친 누구에게나 팔을 넘기는 것으로 봐야 합니다. 또 라이선스 파일이 없으니 코드는 기본적으로 모든 권리가 유보된 상태입니다. 읽을 수는 있지만 복제, 수정, 재배포는 허용되지 않습니다.
결론: 에이전트에게 로봇 팔을 안전하고 설명 가능하게 다루게 하는 방법의 본보기로서, 우리가 읽은 저장소 중 배울 점이 많은 편에 속하며 보정과 정확도에 관한 기록도 드물게 솔직합니다. 설치할 대상으로는 Windows에서 MT4 한 대를 쓰면서 먼저 작성자에게 허락을 구하는 사람에게 맞습니다.
제 역할을 하는 곳
교육용 실습실에 MT4 한 대를 둔 로봇 공학 강사
에이전트가 간단한 요청을 안전한 집기와 놓기로 바꾸는 모습을 보여 주고 싶다
보정 후 Claude Code를 stdio로 연결하고 빨간 큐브를 마커 3에 놓으라고 요청합니다. mt4_scene은 각 엔티티를 집을 수 있는지와 그 이유를 보여 줍니다. 키트는 $1,380이며, 강의 자료에 코드를 재사용하기 전에 작성자에게 허 락을 구하세요.
언어로 안내하는 조작을 시제품으로 만드는 연구자
시각 언어 모델의 판단이 실제 도달 한계 앞에서 얼마나 버티는지 시험하고 싶다
ask_qwen.py를 --dry-run으로 실행하면 Qwen3-VL-4B가 움직이지 않고 판단만 합니다. 그 목표를 팔 자체의 가능 여부 판정과 비교합니다. Qwen과 Grounding DINO 서비스에는 CUDA GPU가 필요합니다.
MT4와 웹캠을 가진 취미 사용자
팔이 지켜보는 사람 없이 마커 위에 큐브를 쌓게 하고 싶다
stack_cubes.py --marker 4 --preview를 실행하면 자리를 비우고, 다시 고쳐 잡으며 집고, 기본값으로 최대 9단까지 쌓습니다. 그 전에 전원을 다시 켤 때마다 calibrate_j4.py를 다시 실행합니다.
도입 전 확인할 점
- 설정
- pip install -r requirements.txt를 실행하고, flash_jog.py로 펌웨어를 기록하고(원래 이미지는 백업되며 복원할 수 있습니다), ArUco 마커 시트를 인쇄하고, 보정 스크립트 다섯 개를 실행한 뒤 python -m mt4_mcp를 시작하거나 Cursor나 Claude Code에 stdio로 등록합니다. Windows, Python 3.10+, avrdude가 포함된 PlatformIO가 필요합니다.
- 연동
- 115200 baud CH340 USB 시리얼 연결로 붙인 WLKATA MT4, USB 장면 카메라, 선택 사항인 Grounding DINO와 Qwen3-VL-4B HTTP 서비스, 프로세스 안에서 도는 SAM 2.1, 원격 클라이언트용 ngrok과 FastMCP Google OAuth, 수동 조작용 Xbox 게임패드.
- 데이터와 개인정보
- 카메라 프레임과 장면 데이터는 클라이언트를 거쳐 모델 제공업체로 전달됩니다. 보정은 vision_calibration.json에 저장됩니다. HTTP 기본값은 127.0.0.1:8787이며, MT4_MCP_PUBLIC=1은 터널용으로 오리진 보호를 끄고, OAuth에는 Google 클라이언트 ID와 시크릿이 필요합니다.
- 대규모 사용 시 비용
- 코드는 무료로 내려받을 수 있지만 라이선스가 없습니다. WLKATA MT4 Education Kit는 RobotShop에서 $1,380입니다. 선택 사항인 비전 모델은 CUDA GPU가 바람직하며, CPU에서도 느리게 돌아갑니다.
- 제한
- 시리얼 포트는 한 번에 한 프로세스만 쓸 수 있습니다. J4 영점은 전원을 끄거나 다시 기록하면 사라집니다. 이후 보정 단계를 건너뛰면 아무 오류 없이 집기 오차가 15~30 mm 늘어납니다. RobotShop에 따르면 가반 하중은 500 g입니다.
좋은 점
- 엉뚱한 물체를 집지 않고 이유를 밝히며 거부
- 펌웨어의 진입 금지 구역, 소프트 한계, 책상 바닥면
- 보정과 정확도에 관한 자세한 문서
- 이름으로 물체를 찾는 선택 기능
아쉬운 점
- 라이선스 파일이 없어 재사용이 허용되지 않음
- Windows 전용이며 WLKATA MT4 팔과 카메라 필요
- 공개 모드에 허용 계정 목록이 보이지 않음
- 관절 공간 이동과 원점 복귀는 진입 금지 구역을 무시
추천 대상
보정한 책상 위에서 에이전트가 물건을 옮기게 하고 싶고 자체 펌웨어 기록에 거부감이 없는 Windows 사용 WLKATA MT4 소유자.
WLKATA MT4 control stack: 자주 묻는 질문
- WLKATA MT4 control stack, 쓸 만한 가치가 있습니까?
- 꼼꼼하고 문서화가 잘된 로봇 공학 작업이지만, 바로 이 팔과 Windows PC, 한나절의 보정이 필요하며 라이선스가 없어 법적으로 자유롭게 재사용할 수 없습니다. 평점은 5점 만점에 3.2점입니다.
- WLKATA MT4 control stack의 가격은 얼마입니까?
- 다운로드는 무료지만 라이선스가 공개되지 않았습니다. WLKATA MT4 Education Kit는 RobotShop에서 $1,380입니다.
- WLKATA MT4 control stack의 단점은 무엇입니까?
- 라이선스 파일이 없어 재사용이 허용되지 않음; Windows 전용이며 WLKATA MT4 팔과 카메라 필요; 공개 모드에 허용 계정 목록이 보이지 않음; 관절 공간 이동과 원점 복귀는 진입 금지 구역을 무시.
- WLKATA MT4 control stack에 적합한 사람은 누구입니까?
- 보정한 책상 위에서 에이전트가 물건을 옮기게 하고 싶고 자체 펌웨어 기록에 거부감이 없는 Windows 사용 WLKATA MT4 소유자.
- 팀이나 프로덕션 환경에서 WLKATA MT4 control stack의 비용은 얼마입니까?
- 코드는 무료로 내려받을 수 있지만 라이선스가 없습니다. WLKATA MT4 Education Kit는 RobotShop에서 $1,380입니다. 선택 사항인 비전 모델은 CUDA GPU가 바람직하며, CPU에서도 느리게 돌아갑니다.
- WLKATA MT4 control stack에 회사 데이터를 맡겨도 안전합니까?
- 카메라 프레임과 장면 데이터는 클라이언트를 거쳐 모델 제공업체로 전달됩니다. 보정은 vision_calibration.json에 저장됩니다. HTTP 기본값은 127.0.0.1:8787이며, MT4_MCP_PUBLIC=1은 터널용으로 오리진 보호를 끄고, OAuth에는 Google 클라이언트 ID와 시크릿이 필요합 니다.
답변 확인일: 2026년 11월 14일.