giteadmin/mcp-demo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
22c3863a44
mcp-demo/skills/kimi-webbridge/references/operations.md
Codex Backup 22c3863a44 Important files backup: 2026-07-27 14:36:05
2026-07-27 14:36:05 +08:00

1.9 KiB
Raw Blame History

Operations: daemon lifecycle and recovery

Read this only when a tool call can't reach the daemon, or the user explicitly asks to install / start / troubleshoot kimi-webbridge.

The daemon

The kimi-webbridge binary lives at ~/.kimi-webbridge/bin/kimi-webbridge (Windows: %USERPROFILE%\.kimi-webbridge\bin\kimi-webbridge.exe) and serves a local HTTP daemon on 127.0.0.1:10086. Status, PID, and logs live under ~/.kimi-webbridge/.

Recovery — what to do when a tool call fails

  1. Daemon not reachable (connection refused) → start it yourself, don't ask the user. start is idempotent: it no-ops if the daemon is already up, and concurrent starts converge to a single daemon (the OS lets only one process bind port 10086).

    • macOS / Linux: ~/.kimi-webbridge/bin/kimi-webbridge start
    • Windows: & "$env:USERPROFILE\.kimi-webbridge\bin\kimi-webbridge.exe" start

    Then retry the tool call.

  2. command not found / binary missing → not installed. Point the user to the help page below to install it.

  3. Extension won't connect, or anything still broken after a start + retry → don't deep-troubleshoot. Point the user to the help page:

Do NOT do automatically

Never run stop / restart / uninstall on your own. They kill the running daemon; if the user runs the Kimi Desktop App (which manages its own daemon), an external stop/restart also fights the app. If a hard restart is genuinely needed, ask the user to do it themselves — reopen the Kimi Desktop App, or run kimi-webbridge restart by hand.

/status JSON fields

  • running (bool) — daemon listening on :10086
  • version (string) — daemon build version
  • extension_connected (bool) — a WebSocket client (the browser extension) is attached
  • extension_id (string) — the Chrome/Edge extension ID, empty if none
  • uptime_seconds (int)