Drission Page Better MCP

Drission页面优化MCP

更好的DrissionPage MCP服务器——涵盖了原始库的大部分功能、255个单元测试、100%的服务覆盖率、AI优化的工具调用和描述。

英语| 中文

______________________________________________________________________

为什么选择BetterMCP

快速开始

先决条件

• Python>=3.10
• 紫外线
• Chrome/Chromium浏览器

安装

git clone https://github.com/pureTrue/DrissionPage-BetterMCP.git
cd DrissionPage-BetterMCP
uv sync

配置您的AI工具

克劳德代码

项目根目录 .mcp.json:

{
  "mcpServers": {
    "drissionpage": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/DrissionPage-BetterMCP", "dp-mcp"]
    }
  }
}

或者通过CLI：

claude mcp add drissionpage -- uv run --directory /path/to/DrissionPage-BetterMCP dp-mcp

光标

.cursor/mcp.json （项目层面）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "drissionpage": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/DrissionPage-BetterMCP", "dp-mcp"]
    }
  }
}

VS代码（副本）

.vscode/mcp.json:

{
  "servers": {
    "drissionpage": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/DrissionPage-BetterMCP", "dp-mcp"]
    }
  }
}

注：VS代码使用 servers 作为顶级密钥，不是 mcpServers.

法典

.codex/config.toml （项目层面）或 ~/.codex/config.toml （全球）：

[mcp_servers.drissionpage]
command = "uv"
args = ["run", "--directory", "/path/to/DrissionPage-BetterMCP", "dp-mcp"]

或者通过CLI：

codex mcp add drissionpage -- uv run --directory /path/to/DrissionPage-BetterMCP dp-mcp

替换 /path/to/DrissionPage-BetterMCP 与实际项目路径。

环境变量

可选，前缀为 DP_MCP_:

复制 .env.example 到 .env 并根据需要进行定制。

刀具清单

浏览器管理

选项卡管理

页面导航

元素交互

截图

页面内容

内嵌框架

网络捕获

Cookie和存储

键盘和对话框

高级

文件操作

开发者指南

项目结构

src/dp_mcp/
├── server.py              # MCP server — 55 tool definitions
├── config.py              # Settings (pydantic-settings)
├── models.py              # ToolResult, BrowserInfo, TabInfo, etc.
├── core/                  # Core services
│   ├── browser.py         # Browser lifecycle
│   ├── tab.py             # Multi-tab management
│   ├── navigation.py      # Page navigation
│   └── element.py         # Element finding & interaction
├── services/              # Domain services
│   ├── screenshot.py      # Screenshots
│   ├── frame.py           # Iframes
│   ├── scroll.py          # Scrolling
│   ├── network.py         # Network capture
│   ├── cookie.py          # Cookies
│   ├── action.py          # Action chains
│   ├── dialog.py          # Dialogs
│   ├── cdp.py             # CDP
│   └── file.py            # File operations
└── utils/
    └── locator.py         # Locator parser + element cache

运行测试

# Unit tests (no browser needed)
uv run pytest tests/unit -v

# Integration tests (requires Chrome)
uv run pytest tests/integration -v -m integration

# All tests
uv run pytest -v

定位器语法

支持完整的DrissionPage定位器语法：

使用可选 by 要消除歧义的参数： css, xpath, text, id, class, attr.

贡献

欢迎提交请求和问题。

1. 复刻此仓库
2. 创建要素分支： git checkout -b feature/my-feature
3. 提交您的更改： git commit -m "feat: add my feature"
4. 按下分支： git push origin feature/my-feature
5. 打开拉取请求

请确保在提交之前通过所有测试：

uv run pytest tests/unit -v

许可证

此项目的代码已获得许可 BSD 3-条款.

备注：该项目取决于 驱动页面，它使用禁止未经授权的商业使用的自定义非商业许可。用户必须独立遵守DrissionPage的许可条款。