MCP server agent-browser
Commit 14 de out. de 2026Permite que clientes de IA controlem um navegador Chromium real para navegar em sites, preencher formulários, clicar em elementos e capturar screenshots.
Também conhecido como codeChap/mcp-server-agent-browser, mcp-server-agent-browser
- Stars
- 1
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 0.1.0
- Último commit
- 14 de out. de 2026
- Licença
- —
O que é o MCP agent-browser?
Permite que clientes de IA controlem um navegador Chromium real para navegar em sites, preencher formulários, clicar em elementos e capturar screenshots.
Resumo gerado a partir do README do projeto
Sobre o MCP server de agent-browser
Controlar um navegador Chromium real de dentro de um cliente de IA permite que desenvolvedores automatizem interações web complexas que a simples busca de documentos não consegue resolver. Este MCP server encapsula a ferramenta agent-browser para fornecer recursos como navegação em sites, preenchimento de formulários, clique em elementos específicos e captura de screenshots ou snapshots da árvore de acessibilidade. Ele foi projetado para usuários que precisam de um agente para interagir com aplicações web dinâmicas, em vez de apenas ler textos estáticos.
A configuração requer a instalação da CLI agent-browser via cargo e a configuração do cliente MCP usando um comando stdio. Os usuários podem gerenciar sessões por meio de um arquivo de configuração para habilitar a persistência, que salva cookies e localStorage para garantir que os logins permaneçam ativos entre reinicializações. O servidor suporta os modos headless e headed, permitindo que você veja a janela do navegador se estiver configurado. Ele inclui ferramentas especializadas como browser_doctor para solução de problemas e browser_get_text para realizar buscas com regex no conteúdo da página.
O que você pode fazer com ele
- 1Automação de envio de formulários webUm agente de IA pode navegar até uma URL específica e inserir dados em campos de entrada usando a ferramenta browser_fill.
- 2Verificação visual de páginas webVocê pode instruir uma IA a tirar uma foto de uma parte específica de um site para confirmar uma mudança visual.
- 3Extração de padrões de texto específicosUm desenvolvedor pode usar regex para encontrar informações específicas dentro do texto de uma página web.
- 4Manutenção de sessões web autenticadasO servidor pode salvar estados de login para que a IA não precise se reautenticar toda vez que iniciar uma nova tarefa.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Verificações automatizadas
Executado em 15 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelcodechap/mcp-server-agent-browser is public and reachablegithub.com/codechap/mcp-server-agent-browser ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)No licenseProblema encontrado
- Commit ou release no último anoLast commit or release 2026-10-14github.com/codechap/mcp-server-agent-browser ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no GitHubmcp-server-agent-browser
Status: Beta — CLI wrapper is covered by unit tests and a fake-browser stdio smoke test. Cookie restore across a real Chromium restart is still a manual check.
Let LLMs drive a real browser. This MCP server wraps agent-browser (Vercel Labs) so any MCP client can navigate, fill forms, click, snapshot the accessibility tree, and screenshot.
It is not Grok's web_search / open_page. Those fetch documents. This one runs Chromium. Use search to find a URL, then browser_navigate.
Prerequisites
cargo install agent-browser
agent-browser install
Call browser_doctor if anything is missing.
Build
cargo build --release
Binary: target/release/mcp-server-agent-browser
cargo test
./tests/test-stdio.sh
Real Chromium login-restore is not in CI. After a headed login, restart the MCP process and confirm the next browser_navigate is still logged in.
Configuration
MCP client (stdio):
{
"mcpServers": {
"agent-browser": {
"command": "/path/to/mcp-server-agent-browser"
}
}
}
Optional TOML at ~/.config/mcp-server-agent-browser/config.toml (see config.example.toml). Missing file uses defaults. Override the path with MCP_AGENT_BROWSER_CONFIG.
| Setting | Default | Meaning |
|---|---|---|
headed |
false |
Show a window. Launch-time only; browser_close first if a headless daemon is already up. Also AGENT_BROWSER_HEADED=1. |
persist |
true |
--session-name <namespace>-<session_id> (default session key default). There's no --namespace CLI flag — namespace is folded into that name instead. |
keep_daemon |
false |
If false, MCP exit runs close so restore state is saved and Chrome does not leak. |
namespace |
mcp-server |
Prefix of the --session-name restore key, isolating this MCP's restore files from a human using the CLI directly. |
command_timeout_secs |
120 |
Wrapper timeout. Playwright's own 25s action timeout is left alone (CLI IPC is ~30s). |
idle_timeout |
1h |
Sets AGENT_BROWSER_IDLE_TIMEOUT_MS (env only — there's no --idle-timeout CLI flag). Use "0" with keep_daemon = true. |
download_dir |
~/Downloads |
--download-path. ~ is expanded. |
profile |
unset | Optional persistent Chrome user-data dir. Not your daily Chrome profile. |
encryption_key_file |
unset | Sets AGENT_BROWSER_ENCRYPTION_KEY. Restore files are credentials; plaintext unless this is set. |
AGENT_BROWSER_PATH |
agent-browser |
CLI binary. |
allowed_domains is optional. Localhost is allowed unless you set a list that excludes it.
What it can do
Same interaction set as before (navigate, click, type, snapshot, screenshot, cookies, eval, CDP, sessions), plus:
browser_doctor— CLI, config, persist, headed/DISPLAY, daemon guess. Does not launch Chrome.browser_get_textpattern— regex over page text with two lines of context.browser_wait—load/url/textas well as a selector.
Typical loop:
browser_navigatebrowser_snapshot(-ifor interactive)browser_click/browser_fillwith@refsbrowser_screenshotif you need pixels
Persistence
With persist = true (default), each session saves cookies and localStorage on close and on the CLI's autosave interval. State lives under ~/.agent-browser/, namespaced to mcp-server. Isolated session_ids do not share a restore key.
Headed login once, browser_close or exit the MCP, start again. The next navigate should restore that session.
A killed MCP process may leave the daemon running. browser_doctor reports that. Idle shutdown still saves if persist is on.
Limitations
- Chromium via
agent-browser(Playwright). No search. - Headed is ignored until the existing daemon is closed.
- Snap Chromium on Ubuntu can fail to advertise its DevTools port; prefer
agent-browser install's browser orexecutable_path. - Writes (screenshot, pdf, download) must be relative, under
/tmp, or underdownload_dir. - Element screenshots take a CSS selector or
@ref, plus a trailing:has-text("..."). The selector is checked first, so a miss is an error, not a silent full-viewport shot. Not combinable withfull_page. - 25s Playwright action timeout is an upstream CLI limit, not this wrapper.
License
MIT
Perguntas sobre o MCP agent-browser
Qual é a diferença entre esta ferramenta e ferramentas de busca web?
Diferente de ferramentas que apenas buscam documentos, este MCP server executa uma instância real do Chromium para interagir com páginas web.
O navegador consegue manter sessões de login?
Sim, por padrão ele salva cookies e localStorage para permitir a restauração da sessão após reinicializações.
Como posso ver a janela do navegador enquanto ele trabalha?
Você pode ativar o modo headed configurando a opção headed como true.
O que acontece se o processo MCP for encerrado inesperadamente?
Um processo encerrado pode deixar o daemon do navegador rodando, o que pode ser verificado usando a ferramenta browser_doctor.