pyBittle-mcp-서버

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

특징

• Bluetooth를 통해 Bittle에 연결

• 움직임과 자세 명령(앞으로, 뒤로, 돌기, 앉기, 쉬기 등)을 보여줍니다.

• 원격 및 프로그래밍 제어를 위한 MCP 도구와 통합

• 모든 활동을 bittle_mcp.log 에 기록합니다.

Related MCP server: Bluetooth MCP Server

요구 사항

• 파이썬 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 라이센스