X ELIO Education · AI 심화
buddy-mcp — AI로 로봇을 제어하다
Buddy MCP Server는 Bluetooth 시리얼로 호환 보드(엘리오)를 제어하는 MCP 서버입니다.
AI 클라이언트(Claude Desktop·Cursor)가 자연어 명령을 보드 동작으로 변환합니다.
'모터를 50%로 돌려줘' 라고 말하면 엘리오가 실제로 움직인다.
무엇인가
코드 대신 말로 로봇을 움직이는 AI 시대 코딩입니다.
AI 클라이언트와 보드 사이의 MCP 서버
Claude Desktop·Cursor에서 받은 자연어 명령을 Bluetooth 시리얼 기반 보드 동작으로 연결합니다.
도구 사다리의 최상위 단계
교육적으로는 X 트랙 · AI 심화에 해당합니다. 블록코딩을 넘어 AI에게 의도를 말로 전달하는 단계입니다.
MCP 도구 7개
포트 확인부터 연결, 구동, 센서 설정, 연결 해제까지 필요한 도구를 제공합니다.
| 도구 | 기능 |
|---|---|
| buddy_list_ports | 시리얼 포트 목록 확인 |
| buddy_connect(port) | 포트 연결(비우거나 "auto" → "nRF"로 시작하는 포트 자동 선택) |
| buddy_send_dc | DC 모터 제어 |
| buddy_send_servo | 서보 모터 제어 |
| buddy_send_io | IO 출력 제어 |
| buddy_sensor_config | 센서 설정 |
| buddy_disconnect | 연결 해제 |
시작하기 6단계
로컬 설정 JSON과 stdio 방식으로 MCP 클라이언트에 연결합니다.
저장소 클론
git clone https://github.com/johnsnow-nam/buddy-mcp.git → cd buddy-mcp
MCP 설정 JSON 출력
macOS/Linux python3 run.py --print-mcp-config · Windows python run.py --print-mcp-config
설정 파일 위치
macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json · Linux ~/.config/Claude/claude_desktop_config.json
buddy 블록 추가
설정 파일의 mcpServers 안에 buddy 블록을 추가합니다.
{ "mcpServers": { "buddy": { "command": "python3", "args": ["/path/to/buddy-mcp/run.py"] } } }클라이언트 재시작
Claude Desktop 또는 Cursor를 재시작합니다.
도구 사용
채팅에서 buddy_list_ports → buddy_connect → buddy_send_dc/send_servo/send_io/sensor_config.
요구 사항
로컬 전용 구동을 전제로 합니다.
실행 환경
- Python 3.10+
- 호환 보드(엘리오) + Bluetooth 동글
- MCP 클라이언트(Claude Desktop/Cursor)
- 로컬 전용(설정 JSON + stdio)
.venv로만 구동(run.py가 자동 생성)- stdout 리다이렉트 금지
AI 심화 로봇 제어 수업, 엘리오 교육 도입으로 연결합니다.
블록코딩 이후 단계에서 자연어 기반 로봇 제어를 교육 흐름에 맞춰 구성합니다.