Home › Other › ble-mcp-server

ble-mcp-server

Let AI agents interact with real BLE hardware — scan, connect, read, write, and subscribe.

Python

★ 18 stars Last pushed 2026-03-30 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (pypi 0.3.0)

uvx ble-mcp-server

Or add to your MCP client config:

{
  "mcpServers": {
    "ble-mcp-server": {
      "command": "uvx",
      "args": [
        "ble-mcp-server"
      ],
      "env": {
        "BLE_MCP_ALLOW_WRITES": "<YOUR_VALUE>",
        "BLE_MCP_WRITE_ALLOWLIST": "<YOUR_VALUE>",
        "BLE_MCP_PLUGINS": "<YOUR_VALUE>",
        "BLE_MCP_TOOL_SEPARATOR": "<YOUR_VALUE>"
      }
    }
  }
}

BLE_MCP_ALLOW_WRITES — Enable BLE characteristic writes (off by default for safety)
BLE_MCP_WRITE_ALLOWLIST — Comma-separated UUID allowlist for writable characteristics
BLE_MCP_PLUGINS — Plugin policy: 'all' or comma-separated plugin names. Unset = disabled.
BLE_MCP_TOOL_SEPARATOR — Tool name separator character (default '_'). Set to '.' if your client supports dots.

Package (pypi 0.3.0)

Package: pypi ble-mcp-server

BLE_MCP_ALLOW_WRITES — Enable BLE characteristic writes (off by default for safety)
BLE_MCP_WRITE_ALLOWLIST — Comma-separated UUID allowlist for writable characteristics
BLE_MCP_PLUGINS — Plugin policy: 'all' or comma-separated plugin names. Unset = disabled.
BLE_MCP_TOOL_SEPARATOR — Tool name separator character (default '_'). Set to '.' if your client supports dots.
BLE_MCP_MAX_SESSIONS — Maximum concurrent MCP sessions (default 1).
BLE_MCP_AUTH_TOKEN required secret — Password for OAuth approval page. Required unless --no-auth is used.

Package (pypi 0.3.0)

Package: pypi ble-mcp-server

BLE_MCP_ALLOW_WRITES — Enable BLE characteristic writes (off by default for safety)
BLE_MCP_WRITE_ALLOWLIST — Comma-separated UUID allowlist for writable characteristics
BLE_MCP_PLUGINS — Plugin policy: 'all' or comma-separated plugin names. Unset = disabled.
BLE_MCP_TOOL_SEPARATOR — Tool name separator character (default '_'). Set to '.' if your client supports dots.
BLE_MCP_MAX_SESSIONS — Maximum concurrent MCP sessions (default 1).
BLE_MCP_AUTH_TOKEN required secret — Password for OAuth approval page. Required unless --no-auth is used.