kimi-webbridge-mcp
kimi-webbridge-mcp bridges the Kimi WebBridge daemon and browser extension to MCP clients, enabling real-browser automation using your existing logged-in profile — without exporting cookies.
Core Capabilities
Status & Connection
wb_status— Check if the WebBridge daemon and browser extension are connected and ready
Navigation
wb_navigate— Open or navigate to a URL (with optional new tab and tab group labeling)wb_go_back/wb_go_forward— Browser history navigationwb_reload— Reload the current page (with optional cache-bypass)
Tab Management
wb_list_tabs— List all tabs in the current session/groupwb_find_tab— Select/switch to a tab by URL (fuzzy match) or active focuswb_close_tab— Close the current session tabwb_close_session— Close all tabs in the session group
Page Reading & Inspection
wb_snapshot— Get the accessibility tree with element references (@erefs) for interactionwb_get_text— Extract visible page text (ideal for articles/content)wb_find— Search the accessibility tree by text, role, or reference
Interaction
wb_click— Click an element by@eref or CSS selector; auto-follows new tabs opened by the clickwb_fill— Clear and fill input fields, textareas, or contenteditable elementswb_press_key— Press a key or keyboard combo (e.g., Enter, Escape, Control+A)wb_scroll— Scroll the page or a specific element (supports direction, pixel delta, or scroll-into-view)
Scripting & Debugging
wb_evaluate— Execute arbitrary JavaScript in the page contextwb_network— Capture and inspect network requests (start/stop/list/detail)wb_console— Capture and inspect browser console logs and errors
Media & Files
wb_screenshot— Take a screenshot of the current tab or a specific element (JPEG by default, with auto-retry and size cap)wb_upload— Set files on a<input type=file>element using local filesystem paths
Full Profile Only (when WEBBRIDGE_TOOL_PROFILE=full)
wb_set_session— Set an explicit session for isolated browsing contextswb_dblclick— Double-click an elementwb_hover— Hover over an elementwb_fill_form— Fill a form with multiple fields at oncewb_cdp— Directly execute Chrome DevTools Protocol commandswb_save_as_pdf— Save the current page as a PDF
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kimi-webbridge-mcpOpen my Gmail and show unread emails"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
kimi-webbridge-mcp
把 Kimi WebBridge(daemon + 浏览器扩展)接到 Agent,采用与 Claude in Chrome 相同的架构分层(不是去接入 Claude 产品):
层 | 本仓库 | 作用 |
Skill(薄) |
| 何时用、工作流、禁止 curl |
MCP |
| 真正执行: |
Grok Build(或其它 MCP 客户端)
├── Skill 路由 + 用法约定
└── MCP kimi-webbridge → :10086 daemon → 扩展 → 真实浏览器真实浏览器 profile / 登录态(不导出 Cookie)
默认 compact ≈ 22 个工具(Claude-in-Chrome 体量,少而稳)
WEBBRIDGE_TOOL_PROFILE=full才开启 cdp / pdf / hover / fill_form 等扩展错误带
problem+hint;截图 jpeg 默认 quality 55 + 重试;click跟随 session 新标签;scroll支持 SPA/视频页
独立开源适配层,与 Moonshot / Kimi / xAI 无隶属关系。需自行安装官方 WebBridge。
前置条件
wb_status → MCP ensureDaemon(daemon 未跑则自动 start :10086)
→ ready=true 后再 wb_navigate / 业务工具排障也可手动:
& "$env:USERPROFILE\.kimi-webbridge\bin\kimi-webbridge.exe" start
& "$env:USERPROFILE\.kimi-webbridge\bin\kimi-webbridge.exe" status详见 Skill skills/kimi-webbridge/SKILL.md §0。
Related MCP server: Scout
安装(MCP + Skill)
git clone https://github.com/Nimm0ny/kimi-webbridge-mcp.git
cd kimi-webbridge-mcp
npm install
npm run doctorGrok Build
MCP — ~/.grok/config.toml(路径改成你的 clone):
[mcp_servers.kimi-webbridge]
command = "node"
args = ["D:\\path\\to\\kimi-webbridge-mcp\\src\\index.js"]
enabled = true
startup_timeout_sec = 15
tool_timeout_sec = 180
[mcp_servers.kimi-webbridge.env]
WEBBRIDGE_TOOL_PROFILE = "compact"
# Optional: only if sites open tabs outside the agent group
# WEBBRIDGE_CLICK_BORROW_ACTIVE = "1"Skill(薄 playbook):
Copy-Item -Recurse -Force skills\kimi-webbridge "$env:USERPROFILE\.grok\skills\kimi-webbridge"验证:
grok mcp doctor kimi-webbridge
# 或
npm run doctor
# wb_status 应显示 tool_profile=compact 与 tool_count≈22工具摘要
Compact(默认)
wb_status · wb_navigate · wb_go_back · wb_go_forward · wb_reload · wb_list_tabs · wb_find_tab · wb_close_tab · wb_close_session · wb_snapshot · wb_get_text · wb_find · wb_wait · wb_click · wb_fill · wb_press_key · wb_scroll · wb_evaluate · wb_screenshot · wb_network · wb_console · wb_upload
Full only
wb_set_session · wb_dblclick · wb_hover · wb_fill_form · wb_cdp · wb_save_as_pdf
精确数量以 npm run smoke / wb_status.tool_count 为准(由 src/tool-profile.js 单一源计算)。
环境变量
变量 | 默认 | 含义 |
|
| daemon(仅允许 localhost) |
|
| 默认 session |
|
| 单次 command 超时 |
|
|
|
|
|
|
|
| 截图单次尝试超时 |
|
| 截图 base64 嵌入上限 |
|
| status 缓存 TTL |
与 chrome-devtools-mcp
本项目 | chrome-devtools | |
浏览器 | 日常 profile | 常为独立实例 |
登录态 | 复用 | 另配 |
角色 | 真实站点操作 | 性能 / 干净环境 |
开发
npm start # MCP stdio (compact)
npm run doctor # daemon + extension + profile + tool count
npm run smoke # list-only compact tools
# full list-only:
# PowerShell: $env:WEBBRIDGE_TOOL_PROFILE='full'; npm run smoke
npm run smoke:e2e # browser smoke with full profile (dev clone)安全
只连本机
:10086(非 localhost 的WEBBRIDGE_URL会被拒绝)Agent 可操作已登录站点;勿在不受信任务中启用
compact 含
wb_evaluate(页面 JS,可触及页面可见状态;勿用于窃取密钥)full 含
wb_cdp:权限更大,仅在需要时开启登录 / 验证码 / 扫码:在真实浏览器由用户完成,不要把密码写进对话
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityDmaintenanceA session-based MCP server that provides advanced browser automation capabilities, allowing users to control browsers, navigate websites, interact with elements, capture screenshots, generate PDFs, and manage cookies through natural language.351MIT
- AlicenseBqualityCmaintenanceBrowser MCP server that connects to your existing browser, preserving sessions, passwords, and extensions, enabling AI agents to interact with web pages without bot detection.3171MIT
- FlicenseCqualityDmaintenanceEnables browser automation, including navigation, form filling, login with CAPTCHA handling, and element manipulation, using a Chrome-based MCP server.364
- -licenseNot gradedqualityNot gradedmaintenanceMCP server that connects AI agents to a real Chrome browser via a WebSocket extension bridge, enabling over 40 browser control tools without debug mode or profile isolation.
Related MCP Connectors
Stealth web browser for agents: search, fetch, click, download and type in persistent MCP sessions.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Nimm0ny/kimi-webbridge-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server