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

Related MCP server: Bluetooth MCP Server

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