How jiawei686/jev-ultrafast-mcp works
jev-ultrafast-mcp is a browser-automation product with two user-facing surfaces: an MCP server for agents and a Chrome extension for observation and macro replay. The main agent workflow submits a goal, lets the server choose and execute guarded page actions, then checks the result with code. The graph also shows direct observe/act tools, macro replay, and the extension’s parallel replay path. Source excerpts are partial, so uncertain internal dispatch details are omitted; documented capabilities are retained.
Main entry points: server.py MCP tool server · session.js Extension session · browser.py Browser session · popup.js Extension popup
Components 20
MCP orchestration
- MCP tool server
jev_ultrafast_mcp/server.py - Runtime config
jev_ultrafast_mcp/config.py
Browser runtime
- Browser session
jev_ultrafast_mcp/browser.py - CDP transport
jev_ultrafast_mcp/cdp.py - Page observer
jev_ultrafast_mcp/js/observer.js - URL safety
jev_ultrafast_mcp/safety.py
Goal capabilities
- Goal policy
jev_ultrafast_mcp/policy.py - Result assertions
jev_ultrafast_mcp/assertions.py - Macro recording
jev_ultrafast_mcp/macros.py
Chrome extension
- Extension popup
chrome-extension/popup.js - Extension worker
chrome-extension/background.js - Extension session
chrome-extension/lib/session.js - Extension observer
chrome-extension/lib/observer.js - Macro resolver
chrome-extension/lib/macro.js - Macro storage
chrome-extension/lib/store.js - Observation renderer
chrome-extension/lib/render.js
Other components
- Agent / MCP client
- Web page
- Chromium browser
- TypeSafe decision model
Connections 23
- Agent / MCP client → MCP tool server: calls tools
- MCP tool server → Runtime config: reads settings
- MCP tool server → Browser session: opens and operates
- MCP tool server → Goal policy: runs goal loop
- MCP tool server → Result assertions: checks result
- MCP tool server → Macro recording: records and replays
- Browser session → URL safety: checks navigation
- Browser session → CDP transport: sends commands
- CDP transport → Chromium browser: controls browser
- Browser session → Page observer: injects and reads
- Page observer → Web page: observes and guards
- Chromium browser → Web page: renders
- Goal policy → TypeSafe decision model: requests decisions
- Extension popup → Extension worker: sends requests
- Extension popup → Observation renderer: renders observations
- Extension worker → Extension session: creates and dispatches
- Extension worker → Macro storage: manages macros
- Extension session → Extension observer: reads page state
- Extension session → Macro resolver: resolves replay
- Extension session → Chromium browser: drives active tab
- Extension observer → Web page: observes and guards
- Extension popup → Macro storage: lists macros
- Extension session → Observation renderer: formats observation