ble-mcp-server

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

stdio v0.1.5

Connection Configuration

Add this to your AI agent's MCP config file to connect.

Run in your terminal:

claude mcp add io.github.es617--ble-mcp-server -- uvx

Transport

stdio

Authentication

None

Version

v0.1.5

Server Name

io.github.es617/ble-mcp-server

Last Updated

Mar 7, 2026

How to install and connect this MCP server.

Environment variables you must provide when running this server.

Variable	Description	Required
`BLE_MCP_ALLOW_WRITES`	Enable BLE characteristic writes (off by default for safety)	Optional
`BLE_MCP_WRITE_ALLOWLIST`	Comma-separated UUID allowlist for writable characteristics	Optional
`BLE_MCP_PLUGINS`	Plugin policy: 'all' or comma-separated plugin names. Unset = disabled.	Optional
`BLE_MCP_TOOL_SEPARATOR`	Tool name separator character (default '.'). Set to '_' for clients that reject dots (e.g. Cursor).	Optional