pyBittle-mcp-сервер

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

Функции

• Подключается к Bittle через Bluetooth

• Демонстрирует команды движения и позы (вперед, назад, поворот, сесть, отдохнуть и т. д.)

• Интегрируется с инструментами MCP для удаленного и программного управления

• Регистрирует всю активность в bittle_mcp.log

Related MCP server: Unitree Go2 MCP Server

Требования

• Питон 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 .

Лицензия

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