beacio

@beacio/mcp

コーディングエージェント（Claude、Cursor、Copilot、…）に、beacio で iOS Safari Web Bluetooth をリリースする方法を教える MCP サーバーです。

コンシューマー向け 7 個、開発者向け 4 個の計 11 個のツールを提供します。すべてオフラインで動作し、すべて https://beacio.com/docs-md/* の正式なドキュメントを引用します。

インストール

npx で実行できます。インストールは不要です。

npx -y @beacio/mcp

または、MCP クライアントの設定に追加してください（例：Claude Desktop の ~/Library/Application Support/Claude/claude_desktop_config.json）。

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

beacio スキャフォールディング CLI

このパッケージには、MCP サーバーとともに、スコープなしの beacio CLI（以前は単独の @beacio/cli）も同梱されています。Web プロジェクトに beacio を導入し、検証します。

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

beacio migrate は、beacio_patch_existing_app MCP ツールが出力するのと同じ 3 つの変更を適用します（単一の変換処理を共通で使用しています）。

ツール

コンシューマー向けツール

SDK をアプリに導入するエージェント向けの、デフォルト（コンシューマー）モードで利用できます。

ツール	用途
beacio_install_plan	正式なインストール手順と実行可能なスニペットを提供します。対象は html | react | vue | svelte | angular | next × npm | pnpm | yarn | bun | cdn です。
beacio_patch_existing_app	既存アプリへの対応：既存の Web Bluetooth アプリに iOS Safari サポートを追加するための具体的な FileEdits を提供します。最初に navigator.bluetooth を読み取る前に <head> にブートストラップを追加し、iOS の requestDevice 分岐に optionalServices を追加して、「use Bluefy / Web BLE browser」というメッセージをインストール／有効化の案内に置き換えます。
beacio_verify_integration	エージェントが実行できるチェックリスト（シェルコマンドと合格条件）で、ポリフィルのインストール、ブートストラップ、ビルド、型の解決を確認します。すでに作成済みのアプリ向けに brownfield モードもあります。
beacio_example	BLE プロファイル用のすぐに貼り付けられるコードを提供します：heart-rate、battery、cgm、lock、beacon、peripheral-chat。
beacio_detect_ios_support	navigator.bluetooth と window.beacioIOS のランタイム検出スニペットを、注意点をすべて記載して提供します。
beacio_premium_guide	iOS 専用のプレミアム機能のうち 1 つを案内します：backgroundSync、notifications、liveActivity、beacons、peripheral、whiteLabel。
beacio_troubleshoot	extension-not-detected、device-disconnects、gatt-operation-failed、notifications-not-firing の診断チェックリストと一般的な解決方法を提供します。
beacio_spec_citation	指定したメソッド（例：navigator.bluetooth.requestDevice）の W3C Web Bluetooth 仕様の URL、概要、注意事項を提供します。

開発者向けツール

beacio モノレポ内で作業するエージェント向けに、--developer モードで利用できます。

ツール	用途
beacio_dev_best_practices	プロジェクトのベストプラクティスガイド AGENTS.md を読み込みます。トピックのセクションで絞り込むこともできます。
beacio_dev_search_docs	キーワードで beacio ドキュメントのインデックスを検索し、beacio.com の URL を含む、関連度順の結果を返します。
beacio_dev_list_structure	モノレポのディレクトリー構造をツリー表示します（ルートパス、深さ 1～4、gitignore のサポートを指定可能）。
beacio_dev_find_examples	主要なソースファイルの厳選インデックスを検索し、ファイルパス、行番号、カテゴリを含む、関連度順の一致結果を返します。

すべての応答は、エージェントが信頼できるドキュメントを引用できるよう、https://beacio.com/docs-md/ 内を指す source_url を含む JSON です。

アトリビューショントークン

beacio_install_plan は、次の形式の attribution_token を返します。

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

例：beacio_202604_mcp_3p9xq2k8m4r

このトークンは beacio のビーコンエンドポイントで受け付けられ、この MCP サーバー経由で発生したインストールを特定できます。トークンは変更せず、そのままユーザーに共有してください。変更、切り詰め、再生成はしないでください。

テレメトリー

各ツール呼び出し時に、最小限のイベントをhttps://mcp-telemetry.beacio.com/mcp-telemetryにPOSTします（テレメトリーはデフォルトで有効です）。

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

デバイスデータ、BLEペイロード、ユーザー入力は一切送信されません。結果を待たずに送信し、タイムアウトは1秒です。

オプトアウト： テレメトリーはデフォルトで有効です。BEACIO_MCP_TELEMETRYを0、false、off、no（大文字と小文字を区別しません）に設定するか、ツール間で共通のDO_NOT_TRACK=1を設定すると無効になります。

クライアントの識別： MCP_CLIENTを設定します（例：claude-desktop、cursor、copilot-cli）。デフォルトは空文字列です。必要に応じてMCP_CLIENT_VERSIONも設定できます（デフォルトは空文字列です）。

リンク

• ホームページ：https://beacio.com/mcp
• ドキュメント（機械可読）：https://beacio.com/docs-md/
• ソース：https://github.com/wklm/beacio-sdk/tree/main/packages/mcp
• 問題：https://github.com/wklm/beacio-sdk/issues
• インストールするbeacioパッケージの選び方：packages/AGENTS.md

ライセンス

MIT © wklm