SGavrl
a727fe82ad
Mirror the wiki content into a docs/ tree so GitBook Git Sync can connect to this repo. Adds SUMMARY.md for the table of contents, .gitbook.yaml pointing GitBook at docs/, and converts wiki page links to relative .md paths.
2.2 KiB
2.2 KiB
obscura mcp exposes obscura as a Model Context Protocol server so MCP-capable clients (Claude Desktop, Claude Code, etc.) can drive it.
Run
Stdio (default, for direct client integration):
obscura mcp
HTTP (for remote or shared use):
obscura mcp --http --port 3000
With stealth and proxy:
obscura mcp --stealth --proxy http://proxy.example.com:8080
Tools exposed
The server keeps a live browser session, so tools operate on the current page rather than taking a URL each call. Navigate first, then read or act.
Navigation and lifecycle:
browser_navigate,browser_back,browser_forward,browser_reload,browser_close
Read the page:
browser_snapshot: accessibility/DOM snapshot of the current page.browser_markdown,browser_links,browser_extract: page as markdown, link list, or structured content.browser_interactive_elements,browser_detect_forms: actionable elements and form fields.browser_get_attribute,browser_count,browser_search: read an attribute, count matches, find text.
Interact:
browser_click,browser_fill,browser_fill_form,browser_type,browser_press_key,browser_select_option,browser_scroll
Wait and run JS:
browser_wait_for,browser_wait_for_text,browser_evaluate
Diagnostics:
browser_network_requests,browser_console_messages
Cookies and storage:
browser_get_cookies,browser_set_cookie,browser_clear_cookies,browser_storage_state,browser_set_storage_state
Tabs:
browser_tab_new,browser_tab_list,browser_tab_switch,browser_tab_close
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"obscura": {
"command": "/path/to/obscura",
"args": ["mcp"]
}
}
}
Restart Claude Desktop. The obscura tools appear in the tool list.
Claude Code
claude mcp add obscura /path/to/obscura mcp
With stealth in config
{
"mcpServers": {
"obscura": {
"command": "/path/to/obscura",
"args": ["mcp", "--stealth"]
}
}
}