pyBittle MCP Server

pyBittle-mcp-server

Ein Python MCP-Server (Model Context Protocol) zur Steuerung des Bittle-Roboters über Bluetooth. Dieser Server stellt eine Reihe von Befehlen bereit, um Bittle über das MCP-Protokoll zu bewegen, zu positionieren und mit ihm zu interagieren.

Merkmale

• Verbindet sich über Bluetooth mit Bittle
• Stellt Bewegungs- und Posenbefehle bereit (vorwärts, rückwärts, drehen, sitzen, ruhen usw.)
• Integriert sich mit MCP-Tools für die Fern- und Programmsteuerung
• Protokolliert alle Aktivitäten in bittle_mcp.log

Anforderungen

• Python 3.10+
• UV für die Paketverwaltung
• Bittle-Roboter mit aktiviertem Bluetooth
• pyBittle -Bibliothek
• MCP-Server- Bibliothek

Installation und Einrichtung

1. Installieren Sie uv (empfohlen für schnelles, zuverlässiges Python-Paketmanagement):
   curl -Ls https://astral.sh/uv/install.sh | sh
2. Installieren Sie Abhängigkeiten:
   uv pip install -r requirements.txt # or, if using pyproject.toml: uv pip install -r pyproject.toml

Verwendung

1. Bluetooth konfigurieren: Stellen Sie sicher, dass Ihr Bittle-Roboter eingeschaltet und im Bluetooth-Kopplungsmodus ist.
2. Führen Sie den MCP-Server aus:
   uv pip run python server.py
   Der Server versucht, eine Verbindung zu Bittle herzustellen und den Status in bittle_mcp.log zu protokollieren.
3. Integration mit MCP-Tools:
   • Dieser Server stellt Befehle über das MCP-Protokoll bereit und macht sie für jeden MCP-kompatiblen Client oder jedes MCP-kompatible Tool zugänglich.
   • Sie können die MCP-CLI oder andere MCP-Tools verwenden, um verfügbare Befehle auf Ihrem Bittle-Roboter zu ermitteln und aufzurufen.
   • Beispiel (mit MCP CLI):
     mcp call move_forward mcp call sit mcp call rest
   • Alle verfügbaren Befehle sind in server.py mit @mcp.tool() dekoriert und automatisch beim MCP-Server registriert.

Entwicklung

• Die Hauptlogik befindet sich in server.py .
• Die Protokollierung ist so konfiguriert, dass die Ausgabe sowohl an die Konsole als auch an bittle_mcp.log erfolgt.
• Befehle werden mit @mcp.tool() für die MCP-Anzeige dekoriert.

Fehlerbehebung

• Wenn die Verbindung zum Server fehlschlägt, überprüfen Sie die Bluetooth-Kopplung und stellen Sie sicher, dass kein anderer Prozess die Bittle-Verbindung verwendet.
• Überprüfen Sie bittle_mcp.log auf detaillierte Fehlermeldungen.

Lizenz

MIT-Lizenz