AgentHubAgentHub

ble-mcp-server

MCP ServerMCP Registry官方收录

io.github.es617/ble-mcp-server · v0.3.0

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

源仓库 ↗

概览

ble-mcp-server 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio、streamable-http、sse 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "ble-mcp-server": {
      "command": "uvx",
      "args": [
        "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_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必填secret

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必填secret

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

相关资源

统一 Manifest

{
  "id": "io.github.es617/ble-mcp-server",
  "type": "mcp-server",
  "version": "0.3.0",
  "displayName": "ble-mcp-server",
  "description": "Let AI agents interact with real BLE hardware — scan, connect, read, write, and subscribe.",
  "repository": {
    "url": "https://github.com/es617/ble-mcp-server.git",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "pypi",
        "identifier": "ble-mcp-server",
        "version": "0.3.0",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "BLE_MCP_ALLOW_WRITES",
            "description": "Enable BLE characteristic writes (off by default for safety)"
          },
          {
            "name": "BLE_MCP_WRITE_ALLOWLIST",
            "description": "Comma-separated UUID allowlist for writable characteristics"
          },
          {
            "name": "BLE_MCP_PLUGINS",
            "description": "Plugin policy: 'all' or comma-separated plugin names. Unset = disabled."
          },
          {
            "name": "BLE_MCP_TOOL_SEPARATOR",
            "description": "Tool name separator character (default '_'). Set to '.' if your client supports dots."
          }
        ]
      },
      {
        "registryType": "pypi",
        "identifier": "ble-mcp-server",
        "version": "0.3.0",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "BLE_MCP_ALLOW_WRITES",
            "description": "Enable BLE characteristic writes (off by default for safety)"
          },
          {
            "name": "BLE_MCP_WRITE_ALLOWLIST",
            "description": "Comma-separated UUID allowlist for writable characteristics"
          },
          {
            "name": "BLE_MCP_PLUGINS",
            "description": "Plugin policy: 'all' or comma-separated plugin names. Unset = disabled."
          },
          {
            "name": "BLE_MCP_TOOL_SEPARATOR",
            "description": "Tool name separator character (default '_'). Set to '.' if your client supports dots."
          },
          {
            "name": "BLE_MCP_MAX_SESSIONS",
            "description": "Maximum concurrent MCP sessions (default 1)."
          },
          {
            "name": "BLE_MCP_AUTH_TOKEN",
            "description": "Password for OAuth approval page. Required unless --no-auth is used.",
            "isRequired": true,
            "isSecret": true
          }
        ]
      },
      {
        "registryType": "pypi",
        "identifier": "ble-mcp-server",
        "version": "0.3.0",
        "transport": "sse",
        "environmentVariables": [
          {
            "name": "BLE_MCP_ALLOW_WRITES",
            "description": "Enable BLE characteristic writes (off by default for safety)"
          },
          {
            "name": "BLE_MCP_WRITE_ALLOWLIST",
            "description": "Comma-separated UUID allowlist for writable characteristics"
          },
          {
            "name": "BLE_MCP_PLUGINS",
            "description": "Plugin policy: 'all' or comma-separated plugin names. Unset = disabled."
          },
          {
            "name": "BLE_MCP_TOOL_SEPARATOR",
            "description": "Tool name separator character (default '_'). Set to '.' if your client supports dots."
          },
          {
            "name": "BLE_MCP_MAX_SESSIONS",
            "description": "Maximum concurrent MCP sessions (default 1)."
          },
          {
            "name": "BLE_MCP_AUTH_TOKEN",
            "description": "Password for OAuth approval page. Required unless --no-auth is used.",
            "isRequired": true,
            "isSecret": true
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.es617/ble-mcp-server",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.es617%2Fble-mcp-server/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
ble-mcp-server — MCP Server 安装与配置 · AgentHub