Let AI agents interact with real BLE hardware — scan, connect, read, write, and subscribe.
uvx ble-mcp-server{
"BLE_MCP_ALLOW_WRITES": "YOUR_VALUE_HERE",
"BLE_MCP_WRITE_ALLOWLIST": "YOUR_VALUE_HERE",
"BLE_MCP_PLUGINS": "YOUR_VALUE_HERE",
"BLE_MCP_TOOL_SEPARATOR": "YOUR_VALUE_HERE",
"BLE_MCP_MAX_SESSIONS": "YOUR_VALUE_HERE",
"BLE_MCP_AUTH_TOKEN": "YOUR_SECRET_VALUE"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-es617-ble-mcp-server": {
"url": "https://io-github-es617-ble-mcp-server.example.com"
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
ble-mcp-server is an MCP server for Let AI agents interact with real BLE hardware — scan, connect, read, write, and subscribe.. It supports HTTP, STDIO transport.
Use the generated config in Install. This server runs with uvx ble-mcp-server; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for uvx ble-mcp-server. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for uvx ble-mcp-server. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for uvx ble-mcp-server. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for uvx ble-mcp-server. Add required environment variables before starting Cursor or VS Code.
ble-mcp-server uses HTTP, STDIO transport. Use the package or command config in Install.
ble-mcp-server inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
ble-mcp-server is marked with Auth required by registry metadata auth. You may need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
ble-mcp-serverstdio | pypi | 0.3.0 | Env: BLE_MCP_ALLOW_WRITES Env: BLE_MCP_WRITE_ALLOWLIST Env: BLE_MCP_PLUGINS Env: BLE_MCP_TOOL_SEPARATOR |