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

Related MCP server: Bluetooth MCP Server

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