← Index

io.github.es617/ble-mcp-server

io.github.es617/ble-mcp-server·v0.3.0·Other
Quality Score
80
/100

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

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "ble-mcp-server": {
      "command": "uvx",
      "args": [
        "ble-mcp-server"
      ],
      "env": {
        "BLE_MCP_ALLOW_WRITES": "<ble_mcp_allow_writes>",
        "BLE_MCP_WRITE_ALLOWLIST": "<ble_mcp_write_allowlist>",
        "BLE_MCP_PLUGINS": "<ble_mcp_plugins>",
        "BLE_MCP_TOOL_SEPARATOR": "<ble_mcp_tool_separator>",
        "BLE_MCP_MAX_SESSIONS": "<ble_mcp_max_sessions>",
        "BLE_MCP_AUTH_TOKEN": "<your-ble_mcp_auth_token>"
      }
    }
  }
}
§02  Environment variables
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_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
requiredsecret

Password for OAuth approval page. Required unless --no-auth is used.

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
requiredsecret

Password for OAuth approval page. Required unless --no-auth is used.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
5
§04  Alternatives in Other