pyBittle MCP Server

pyBittle-mcp-서버

블루투스를 통해 Bittle 로봇을 제어하는 Python MCP(Model Context Protocol) 서버입니다. 이 서버는 MCP 프로토콜을 사용하여 Bittle 로봇의 이동, 자세 조정 및 상호작용을 위한 일련의 명령을 제공합니다.

특징

• Bluetooth를 통해 Bittle에 연결
• 움직임과 자세 명령(앞으로, 뒤로, 돌기, 앉기, 쉬기 등)을 보여줍니다.
• 원격 및 프로그래밍 제어를 위한 MCP 도구와 통합
• 모든 활동을 bittle_mcp.log 에 기록합니다.

요구 사항

• 파이썬 3.10+
• 패키지 관리를 위한 uv
• 블루투스가 가능한 작은 로봇
• pyBittle 라이브러리
• mcp-server 라이브러리

설치 및 설정

1. uv를 설치하세요(빠르고 안정적인 Python 패키지 관리를 위해 권장):지엑스피1
2. 종속성 설치:
   uv pip install -r requirements.txt # or, if using pyproject.toml: uv pip install -r pyproject.toml

용법

1. Bluetooth 구성: Little Robot의 전원이 켜져 있고 Bluetooth 페어링 모드에 있는지 확인하세요.
2. MCP 서버를 실행합니다.
   uv pip run python server.py
   서버는 Bittle에 연결을 시도하고 상태를 bittle_mcp.log 에 기록합니다.
3. MCP 도구와 통합:
   • 이 서버는 MCP 프로토콜을 통해 명령을 공개하여 모든 MCP 호환 클라이언트나 도구에서 액세스할 수 있도록 합니다.
   • MCP CLI 나 다른 MCP 도구를 사용하여 Bittle 로봇에서 사용 가능한 명령을 검색하고 호출할 수 있습니다.
   • 예(MCP CLI 사용):
     mcp call move_forward mcp call sit mcp call rest
   • 사용 가능한 모든 명령은 server.py 의 @mcp.tool() 로 장식되어 있으며 MCP 서버에 자동으로 등록됩니다.

개발

• 주요 로직은 server.py 에 있습니다.
• 로깅은 콘솔과 bittle_mcp.log 모두에 출력되도록 구성되어 있습니다.
• MCP 노출을 위해 명령은 @mcp.tool() 로 장식됩니다.

문제 해결

• 서버 연결에 실패하면 Bluetooth 페어링을 확인하고 다른 프로세스가 Bittle 연결을 사용하고 있지 않은지 확인하세요.
• 자세한 오류 메시지는 bittle_mcp.log 확인하세요.

특허

MIT 라이센스