Advertise
MCP.so
Sign In

PyBittle MCP Server

@cluesang

Repository

Basic information

Category

Other

Transports

stdio

Author

cluesang

About PyBittle MCP Server

MCP Server to control pyBittle via BLE

PyBittle MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "pyBittle-mcp-server": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-r",
        "requirements.txt"
      ]
    }
  }
}

PyBittle MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is pyBittle-mcp-server?

pyBittle-mcp-server is a Python MCP (Model Context Protocol) server for controlling the Bittle robot via Bluetooth. It exposes movement and pose commands such as forward, backward, turn, sit, and rest, making them accessible through any MCP‑compatible client.

How to use pyBittle-mcp-server?

Install uv and uvx, then set up dependencies using the provided start_server.sh script or by manually running uv pip install -r requirements.txt. Power on the Bittle robot in Bluetooth pairing mode and start the server with ./start_server.sh. Once running, use MCP tools (e.g., the MCP CLI) to invoke commands like mcp call move_forward.

Key features of pyBittle-mcp-server

  • Connects to Bittle via Bluetooth.
  • Exposes movement and pose commands (forward, backward, turn, sit, rest, etc.).
  • Integrates with MCP tools for remote and programmatic control.
  • Logs all activity to bittle_mcp.log.

Use cases of pyBittle-mcp-server

  • Remote control of a Bittle robot from any MCP‑compatible client.
  • Automating robot movements in scripts or AI‑driven workflows.
  • Integrating robot commands into larger MCP‑based systems.

Frequently asked questions

1

What does pyBittle-mcp-server do?

It acts as a bridge between the MCP protocol and the Bittle robot, allowing movement and pose commands to be sent via Bluetooth.

2

What are the system requirements?

Python 3.10+, `uv`, `uvx`, the pyBittle library, the mcp-server library, and a Bittle robot with Bluetooth enabled.

3

How do I connect the server to Bittle?

Ensure the Bittle is powered on and in Bluetooth pairing mode before launching the server. The server attempts to connect automatically and logs the status.

4

What if the server fails to start?

Check Bluetooth pairing and confirm no other process is using the Bittle connection. Review `bittle_mcp.log` for detailed error messages. If port conflicts occur, `start_server.sh` automatically handles killing existing server processes.

5

What commands are available?

Commands include `move_forward`, `sit`, `rest`, and others. All are decorated with `@mcp.tool()` in `server.py` and automatically registered with the MCP server. Use `mcp call` to invoke them.

Comments

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K
Advertise