MCP server
Ble MCP Server
Let AI agents interact with real BLE hardware — scan, connect, read, write, and subscribe.
- Pricing
- Open source
- Runs
- Remotely or Locally
- Version
- 0.3.0
- Listing updated
- 5 days ago
About Ble MCP Server
Ble MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Install
Run in a terminal
claude mcp add ble-mcp-server -- uvx ble-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"ble-mcp-server": {
"command": "uvx",
"args": [
"ble-mcp-server"
]
}
}
}Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ble-mcp-server": {
"command": "uvx",
"args": [
"ble-mcp-server"
]
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"ble-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"ble-mcp-server"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ble-mcp-server": {
"command": "uvx",
"args": [
"ble-mcp-server"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ble-mcp-server": {
"command": "uvx",
"args": [
"ble-mcp-server"
]
}
}
}Configuration
BLE_MCP_ALLOW_WRITESEnable BLE characteristic writes (off by default for safety)BLE_MCP_WRITE_ALLOWLISTComma-separated UUID allowlist for writable characteristicsBLE_MCP_PLUGINSPlugin policy: 'all' or comma-separated plugin names. Unset = disabled.BLE_MCP_TOOL_SEPARATORTool name separator character (default '_'). Set to '.' if your client supports dots.BLE_MCP_ALLOW_WRITESEnable BLE characteristic writes (off by default for safety)BLE_MCP_WRITE_ALLOWLISTComma-separated UUID allowlist for writable characteristicsBLE_MCP_PLUGINSPlugin policy: 'all' or comma-separated plugin names. Unset = disabled.BLE_MCP_TOOL_SEPARATORTool name separator character (default '_'). Set to '.' if your client supports dots.BLE_MCP_MAX_SESSIONSMaximum concurrent MCP sessions (default 1).BLE_MCP_AUTH_TOKENPassword for OAuth approval page. Required unless --no-auth is used.RequiredBLE_MCP_ALLOW_WRITESEnable BLE characteristic writes (off by default for safety)BLE_MCP_WRITE_ALLOWLISTComma-separated UUID allowlist for writable characteristicsBLE_MCP_PLUGINSPlugin policy: 'all' or comma-separated plugin names. Unset = disabled.BLE_MCP_TOOL_SEPARATORTool name separator character (default '_'). Set to '.' if your client supports dots.BLE_MCP_MAX_SESSIONSMaximum concurrent MCP sessions (default 1).BLE_MCP_AUTH_TOKENPassword for OAuth approval page. Required unless --no-auth is used.Required
Pricing
Open source
Ble MCP Server FAQ
Is Ble MCP Server free?
Yes. Ble MCP Server is open source, so you can use and self-host it for free.
How do I add Ble MCP Server to Claude Code?
Run this command in your terminal: claude mcp add ble-mcp-server -- uvx ble-mcp-server