iOS Web Bluetooth (WebBLE)

io.github.wklm由 GitHub 帳號 wklm 發布v0.1.1更新於 Oct 27, 2026

MCP server to ship Web Bluetooth on iPhone Safari via the WebBLE extension.

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

離線 MCP 伺服器，為編碼助理提供在 iOS Safari 上透過 beacio SDK 使用 Web Bluetooth 的安裝方案、程式碼片段與檢查清單。

可以做什麼
  • 取得各框架與套件管理器的安裝步驟和可執行程式碼片段
  • 為既有 Web Bluetooth 應用程式產生適配 iOS Safari 的具體檔案修改
  • 用可執行的檢查清單與 shell 指令驗證整合是否完成
  • 取得 BLE 設定檔（心率、電池、血糖、鎖、信標等）的可貼上程式碼與執行期偵測片段
  • 查閱 iOS 進階功能指南、疑難排解步驟與 W3C 規範引用
  • 開發者模式：讀取最佳實務、搜尋文件、檢視儲存庫結構、尋找範例
適用情境
適合助理在開發或遷移使用 Web Bluetooth 的網頁應用程式、且需要它在 iPhone Safari 上透過 beacio 擴充功能正常運作時使用；也適合編碼時需要權威 beacio 文件與範例程式碼的情況。
執行需求
透過 npx 以 stdio 在本機執行，需要 Node.js。不需帳號或 API 金鑰。選用環境變數 MCP_CLIENT 與 MCP_CLIENT_VERSION 用來標示用戶端；BEACIO_MCP_TELEMETRY 或 DO_NOT_TRACK 可關閉遙測。開發者工具需加上 --developer 參數。
安裝前請注意
遙測預設開啟：每次工具呼叫都會向 beacio 端點傳送事件（工具名稱、用戶端名稱與版本、是否成功、耗時、歸因權杖）；可用 BEACIO_MCP_TELEMETRY 或 DO_NOT_TRACK 關閉。安裝方案會回傳一個歸因權杖，要求原樣轉交給使用者。此套件另附會修改專案檔案的腳手架命令列工具。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 iOS Web Bluetooth (WebBLE)，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[beacio]

@beacio/mcp

MCP server that teaches coding agents (Claude, Cursor, Copilot, …) how to ship iOS Safari Web Bluetooth with beacio.

Eleven tools (seven consumer + four developer), all offline, all citing canonical docs at https://beacio.com/docs-md/*.

Install

Run via npx — no install step needed:

bash
npx -y @beacio/mcp

Or add it to your MCP client config (example: Claude Desktop, ~/Library/Application Support/Claude/claude_desktop_config.json):

json
{  "mcpServers": {    "beacio": {      "command": "npx",      "args": ["-y", "@beacio/mcp"],      "env": { "MCP_CLIENT": "claude-desktop" }    }  }}

beacio scaffolding CLI

This package also ships the unscoped beacio CLI (formerly the standalone @beacio/cli) alongside the MCP server. It scaffolds and verifies beacio integration in a web project:

bash
npx beacio init       # auto-detect framework and add the detection snippetnpx beacio migrate    # brownfield: patch an existing Web Bluetooth app for iOS Safarinpx beacio check      # verify beacio integration (add --brownfield for an existing app)

beacio migrate applies the same three edits the beacio_patch_existing_app MCP tool emits (single-sourced from one transform).

Tools

Consumer tools

Available in the default (consumer) mode for agents shipping the SDK into an app.

ToolPurpose
beacio_install_planCanonical install steps + runnable snippet for html | react | vue | svelte | angular | next × npm | pnpm | yarn | bun | cdn.
beacio_patch_existing_appBrownfield: concrete FileEdits to add iOS Safari support to an EXISTING Web Bluetooth app — bootstrap into <head> before the first navigator.bluetooth read, optionalServices onto the iOS requestDevice branch, and the "use Bluefy / Web BLE browser" message swapped for the install/enable affordance.
beacio_verify_integrationAgent-runnable checklist (shell commands + pass criteria) confirming the polyfill is installed, bootstrapped, builds, and resolves types — plus a brownfield mode for an already-written app.
beacio_exampleReady-to-paste code for a BLE profile: heart-rate, battery, cgm, lock, beacon, peripheral-chat.
beacio_detect_ios_supportRuntime detection snippet for navigator.bluetooth + window.beacioIOS, with every gotcha noted.
beacio_premium_guideOne of the iOS-only premium surfaces: backgroundSync, notifications, liveActivity, beacons, peripheral, whiteLabel.
beacio_troubleshootDiagnostic checklist + common fix for extension-not-detected, device-disconnects, gatt-operation-failed, notifications-not-firing.
beacio_spec_citationW3C Web Bluetooth spec URL + summary + caveats for a given method (e.g. navigator.bluetooth.requestDevice).

Developer tools

Surfaced with --developer mode, for agents working inside the beacio monorepo itself.

ToolPurpose
beacio_dev_best_practicesRead the project's AGENTS.md best-practices guide, optionally filtered by topic section.
beacio_dev_search_docsSearch the beacio documentation index by keyword; returns ranked results with beacio.com URLs.
beacio_dev_list_structureBuild a tree view of the monorepo directory structure (optional root path, depth 1-4, gitignore support).
beacio_dev_find_examplesSearch a curated index of key source files; returns ranked matches with file path, line number, and category.

Every response is JSON with a source_url that points into https://beacio.com/docs-md/ so agents can cite authoritative docs.

Attribution token

beacio_install_plan returns an attribution_token of the form:

beacio_YYYYMM_mcp_<8..16 chars a–z0–9>

Example: beacio_202604_mcp_3p9xq2k8m4r

This token is accepted by the beacio beacon endpoint so installs originating from this MCP server are attributable. Share the token with the user unchanged — do not modify, truncate, or regenerate it.

Telemetry

Each tool call POSTs a minimal event to https://mcp-telemetry.beacio.com/mcp-telemetry (telemetry is enabled by default):

json
{  "tool": "beacio_install_plan",  "client_name": "claude-desktop",  "client_version": "1.2.3",  "success": true,  "duration_ms": 42,  "attribution_token": "beacio_202604_mcp_3p9xq2k8m4r"}

No device data, no BLE payloads, no user input is ever sent. Fire-and-forget, 1-second timeout.

Opt out: telemetry is on by default; disable it by setting BEACIO_MCP_TELEMETRY to 0, false, off, or no (case-insensitive), or by setting the cross-tool DO_NOT_TRACK=1.

Identify your client: set MCP_CLIENT (e.g. claude-desktop, cursor, copilot-cli). Defaults to an empty string. Optionally set MCP_CLIENT_VERSION (defaults to empty string).

Links

License

MIT © wklm

來源：packages/mcp/README.md，提交 4051dfa

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。