DrissionPage MCP

📋 Requirements

• Python 3.10+ (3.11+ recommended)
• Chrome or Chromium browser
• Any MCP-compatible client: Codex CLI/IDE, Claude Code, Claude Desktop, Cursor, VS Code, etc.

---

🧭 Client Setup Navigation

• Atomic browser control
• Install + screenshot walkthrough
• Codex CLI/IDE quick setup
• Codex CLI/IDE integration example
• Skills and reusable procedures
• Claude Code setup
• Cursor setup
• Claude Desktop setup
• Troubleshooting

---

Install or update Codex CLI (macOS/Linux)

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Install from PyPI

python -m pip install -U "drissionpage-mcp>=0.8.8"

📦 Setup in Codex CLI/IDE (30 seconds)

Codex supports local stdio MCP servers through config.toml; the CLI and IDE extension share the same MCP configuration.

1. Edit Codex configuration: - User-level: ~/.codex/config.toml - Project-level: .codex/config.toml inside a trusted project

2. Add this configuration:

   [mcp_servers.drissionpage]
   command = "drissionpage-mcp"
   startup_timeout_sec = 20
   tool_timeout_sec = 60
   

1. Restart Codex. In the TUI, run /mcp; from a shell, run codex mcp list.

<p align="center"> <img src="https://raw.githubusercontent.com/jumodada/Drissionpage-MCP-Server/assets/06-codex.png" width="700" alt="Codex config.toml"> </p>

For Claude Code, Claude Desktop, and other JSON-based MCP clients, see Integration Examples.

---

Advanced JSON Setup

{
  "mcpServers": {
    "drissionpage": {
      "command": "drissionpage-mcp",
      "args": ["--log-level", "DEBUG"],
      "env": {
        "CHROME_PATH": "/custom/path/to/chrome"
      }
    }
  }
}

Absolute-Python fallback for GUI clients:

{
  "mcpServers": {
    "drissionpage": {
      "command": "/absolute/path/to/python",
      "args": ["-m", "drissionpage_mcp.cli"],
      "env": {
        "CHROME_PATH": "/custom/path/to/chrome",
        "DP_HEADLESS": "1"
      }
    }
  }
}

---

Verify Installation

```bash

Check browser installation

which google-chrome # Linux which chromium # macOS ```

🎯 Quick Examples

🚀 Use Cases

✅ Automated Testing - Test web applications ✅ Data Scraping - Extract structured data from websites ✅ Form Automation - Fill and submit forms ✅ Monitoring - Check for updates or changes ✅ Screenshot Verification - Capture and verify page state ✅ Content Analysis - Analyze web content programmatically

---

📖 Integration Examples

Navigate and Screenshot

"Visit https://example.com and take a screenshot for me"

Verify package and environment

drissionpage-mcp --version drissionpage-mcp doctor ```

The official installer updates an existing Codex CLI installation as well. For Windows and the Codex desktop app, see the official Codex CLI and app documentation.

Then add the Codex or MCP client configuration below and restart your client.

<p align="center"> <img src="https://raw.githubusercontent.com/jumodada/Drissionpage-MCP-Server/assets/01-install.png" width="700" alt="pip install drissionpage-mcp"> <br><br> <img src="https://raw.githubusercontent.com/jumodada/Drissionpage-MCP-Server/assets/03-doctor.png" width="700" alt="drissionpage-mcp doctor — all checks green"> </p>

---

🌍 Browser Environment (6 tools)

• browser_headers_set - Replace extra request headers and return names with redacted values; an empty object clears them
• browser_user_agent_set - Override the user agent and optional platform, returning both the accepted and previous user agents
• browser_cache_clear - Clear HTTP cache while preserving Cookies, localStorage, and sessionStorage
• browser_permission_get - Query one browser permission for the current document origin without opening an OS prompt
• browser_permission_set - Use browser_permission_set(setting="granted") (or "denied"/"prompt") for an exact origin/current Chromium context
• browser_permissions_reset - Reset permission overrides for the current Chromium context

🧩 Optional Skills Discovery

• Resource: drissionpage://skills/catalog
• Prompts: none
• Repository examples: cross-origin-iframe-probe, turnstile-testing, and xiaohongshu-content-research
• Entry point: skills/<skill-name>/SKILL.md; catalog schema v2 includes Skill/MCP versions, required tools, fixture, fixed v0.8.4 source revision, verification status, and SHA-256
• Skills are Markdown procedures for the MCP host. They are not Python modules, are not executed by the server, and are excluded from wheel/sdist packages.

Validate a source checkout with python playground/validate_skills.py --json. Install the fixed catalog release from skills-manager@v0.8.4 with python install.py install --client codex --json or python install.py install --client claude --json.

🔧 Configuration

Optional browser/runtime environment variables:

[mcp_servers.drissionpage.env]

Environment diagnostics; add --launch-browser for a browser startup check

drissionpage-mcp doctor drissionpage-mcp doctor --launch-browser

Data Scraping

"Get the top 10 news headlines from news.ycombinator.com"

---

Codex CLI / IDE (Recommended)

```toml [mcp_servers.drissionpage] command = "drissionpage-mcp" startup_timeout_sec = 20 tool_timeout_sec = 60

Codex CLI / IDE

[mcp_servers.drissionpage]
command = "drissionpage-mcp"
startup_timeout_sec = 20
tool_timeout_sec = 60

Verify with:

codex mcp list

🐛 Troubleshooting