pyBittle MCP Server

pyBittle-mcp-сервер

Сервер Python MCP (Model Context Protocol) для управления роботом Bittle через Bluetooth. Этот сервер предоставляет набор команд для перемещения, позирования и взаимодействия с Bittle с использованием протокола MCP.

Функции

• Подключается к Bittle через Bluetooth
• Демонстрирует команды движения и позы (вперед, назад, поворот, сесть, отдохнуть и т. д.)
• Интегрируется с инструментами MCP для удаленного и программного управления
• Регистрирует всю активность в bittle_mcp.log

Требования

• Питон 3.10+
• uv для управления пакетами
• Робот Bittle с включенным Bluetooth
• библиотека pyBittle
• библиотека mcp-сервера

Установка и настройка

1. Установите uv (рекомендуется для быстрого и надежного управления пакетами Python):
   curl -Ls https://astral.sh/uv/install.sh | sh
2. Установить зависимости:
   uv pip install -r requirements.txt # or, if using pyproject.toml: uv pip install -r pyproject.toml

Использование

1. Настройте Bluetooth: убедитесь, что ваш робот Bittle включен и находится в режиме сопряжения по 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
   • Все доступные команды дополнены @mcp.tool() в server.py и автоматически регистрируются на сервере MCP.

Разработка

• Основная логика находится в server.py .
• Ведение журнала настроено на вывод как на консоль, так и bittle_mcp.log .
• Команды дополнены @mcp.tool() для раскрытия MCP.

Поиск неисправностей

• Если серверу не удается подключиться, проверьте сопряжение Bluetooth и убедитесь, что никакой другой процесс не использует соединение Bittle.
• Подробные сообщения об ошибках см. в файле bittle_mcp.log .

Лицензия

Лицензия Массачусетского технологического института