agent-browser-mcp-codex

로컬 agent-browser 기능을 MCP 도구로 노출하고 Codex 통합을 빠르게 시작할 수 있도록 합니다.

Codex 빠른 시작

전제 조건: agent-browser가 로컬에 이미 설치되어 있어야 합니다.

1. npx agent-browser-mcp-codex init-codex 실행

2. Codex를 재시작하거나 새 세션을 엽니다.

agent-browser가 이미 제공하는 기능

agent-browser는 이미 다음과 같은 광범위한 브라우저 자동화 기능을 제공합니다:

• 탐색 및 상호 작용

• 키보드, 마우스, 업로드, 다운로드 및 스크롤 제어

• 페이지 검사 및 정보 검색

• 탭, 세션, 스토리지 및 네트워크 작업

• 디버깅, diffing, 기록 및 스트리밍

• 인증, 채팅, 대시보드 및 설정 명령

이 MCP 래퍼가 현재 노출하는 기능

이 패키지는 현재 agent-browser 명령의 핵심 하위 집합을 노출합니다:

• 탐색: open, back, forward, reload

• 상호 작용: click, fill, type

• 읽기 및 페이지 상태: get_title, get_text, get_html, snapshot, screenshot, wait

• 탭: tab_list, tab_new, tab_close

• 런타임: eval

• 스토리지 및 네트워크: cookies_get, network_requests

• 세션 및 원시 패스스루: session_current, session_list, session_close, run_raw_command

수동 설정

플러그인을 수동으로 연결하려면 로컬 Codex 템플릿이 codex/plugin/ 아래에 있습니다.

제한 사항

• 이 패키지는 현재 전체 기능이 아닌 업스트림 agent-browser CLI의 하위 집합만 노출합니다.

• 일부 도구 제품군은 현재 의도적으로 제한되어 있습니다.

• 향후 더 넓은 범위의 기능이 추가될 수 있으나, 현재 인터페이스는 계속 발전 중인 것으로 간주해야 합니다.

개발

로컬 검증 방법:

• npm test

• npm run typecheck

릴리스

• 첫 자동 게시 전에 GitHub 저장소에 NPM_TOKEN 시크릿을 구성하십시오.

• GitHub 릴리스를 생성하고 게시하여 현재 패키지 버전에 대한 npm 게시를 트리거하십시오.