pyBittle MCP Server

Servidor pyBittle-mcp

Un servidor MCP (Protocolo de Contexto de Modelo) de Python para controlar el robot Bittle mediante Bluetooth. Este servidor expone un conjunto de comandos para mover, posar e interactuar con Bittle mediante el protocolo MCP.

Características

• Se conecta a Bittle a través de Bluetooth
• Expone comandos de movimiento y pose (adelante, atrás, girar, sentarse, descansar, etc.)
• Se integra con herramientas MCP para control remoto y programático.
• Registra toda la actividad en bittle_mcp.log

Requisitos

• Python 3.10+
• UV para la gestión de paquetes
• Pequeño robot con Bluetooth habilitado
• Biblioteca pyBittle
• biblioteca mcp-server

Instalación y configuración

1. Instalar uv (recomendado para una gestión rápida y confiable de paquetes de Python):
   curl -Ls https://astral.sh/uv/install.sh | sh
2. Instalar dependencias:
   uv pip install -r requirements.txt # or, if using pyproject.toml: uv pip install -r pyproject.toml

Uso

1. Configurar Bluetooth: asegúrese de que su robot Bittle esté encendido y en modo de emparejamiento Bluetooth.
2. Ejecute el servidor MCP:
   uv pip run python server.py
   El servidor intentará conectarse a Bittle y registrará el estado en bittle_mcp.log .
3. Integración con herramientas MCP:
   • Este servidor expone comandos a través del protocolo MCP, haciéndolos accesibles a cualquier cliente o herramienta compatible con MCP.
   • Puede utilizar la CLI de MCP u otras herramientas de MCP para descubrir e invocar comandos disponibles en su robot Bittle.
   • Ejemplo (usando MCP CLI):
     mcp call move_forward mcp call sit mcp call rest
   • Todos los comandos disponibles están decorados con @mcp.tool() en server.py y se registran automáticamente con el servidor MCP.

Desarrollo

• La lógica principal está en server.py .
• El registro está configurado para enviarse tanto a la consola como bittle_mcp.log .
• Los comandos están decorados con @mcp.tool() para la exposición de MCP.

Solución de problemas

• Si el servidor no puede conectarse, verifique el emparejamiento de Bluetooth y asegúrese de que ningún otro proceso esté utilizando la conexión Bittle.
• Revise bittle_mcp.log para obtener mensajes de error detallados.

Licencia

Licencia MIT