Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
{
"name": "browser-mcp",
"version": "0.1.0",
"description": "Browser automation MCP server for Codex CLI - control your browser from coding agents",
"author": {
"name": "BrowserMCP",
"url": "https://github.com/BrowserMCP"
},
"homepage": "https://github.com/BrowserMCP/mcp",
"repository": "https://github.com/BrowserMCP/mcp",
"license": "MIT",
"keywords": [
"mcp",
"browser",
"automation",
"puppeteer",
"web"
],
"mcpServers": "./.mcp.json",
"interface": {
"displayName": "BrowserMCP",
"shortDescription": "Control your browser from Codex via MCP",
"longDescription": "Browser MCP is a Model Context Protocol server that allows AI applications to control your browser. Navigate pages, click elements, fill forms, take screenshots, and extract content.",
"developerName": "BrowserMCP",
"category": "Productivity",
"websiteURL": "https://github.com/BrowserMCP/mcp"
},
"skills": "./skills/"
}
20 changes: 20 additions & 0 deletions .github/workflows/plugin-quality-gate.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
name: Plugin Quality Gate

on:
pull_request:
paths:
- ".codex-plugin/**"
- "skills/**"
- ".mcp.json"

jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Codex plugin quality gate
uses: hashgraph-online/hol-codex-plugin-scanner-action@v1
with:
plugin_dir: "."
min_score: 80
fail_on_severity: high
11 changes: 11 additions & 0 deletions .mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"mcpServers": {
"browsermcp": {
"command": "npx",
"args": [
"-y",
"@browsermcp/mcp"
]
}
}
}
22 changes: 22 additions & 0 deletions skills/browser-mcp/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
name: browser-mcp
description: Control a real browser from Codex - navigate, click, fill forms, screenshot, and extract content via BrowserMCP.
---

# BrowserMCP for Codex

Automate browser interactions through the BrowserMCP MCP server.

## When to use

- Testing web UIs and interactions
- Scraping or extracting content from web pages
- Filling out forms or automating browser workflows
- Taking screenshots of web pages for review
- Debugging layout or rendering issues

## Tips

- Use for visual verification of frontend changes
- Combine with git operations for end-to-end testing workflows
- The browser runs locally and requires a display or headless mode