Skip to main content
Glama
deenesjakoruzh
genxevo

genxevo-selenium

by genxevo
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

GenXEvo AI 自动化代理 — Python Selenium

一个 MCP 服务器，为 AI 编码代理提供可靠的"眼睛"和"双手"，用于 Python + Selenium UI 自动化工程 — 确定性能力、结构化证据、强制安全边界和可验证的结果。

License: MIT Python 3.11 | 3.12 | 3.13 Status: alpha

问题

让任何语言模型修复一个失败的 Selenium 测试，它都会产出一个自信、看似合理、但错误的 XPath。

它不得不这样。它看不到页面，看不到测试输出，通常甚至看不到项目的真实形态——测试套件运行在哪个解释器上、由哪个 runner 收集、页面对象实际存放在哪里。它用流畅的表达来填补这个空白。

GenXEvo 的存在就是为了消除这个空白，让模型有真实的东西可以推理。

Related MCP server: UI Debugger MCP

原则

先有证据，再作修改。先有证据，再言成功。

代理从不凭空发明定位器；它观察定位器。它从不宣布修复完成；它用一次运行来证明修复，该运行通过标识符与它声称已修复的失败相关联。每项能力都返回带有明确信任级别的证据，每个结论都携带产生它的信号，每个结果都在机器可读的字段中说明是否成功——因为一个无法区分成功与失败的代理，会自信地报告一个它从未验证过的修复，而这种结果比完全不帮忙更糟糕。

这是什么，以及这不是什么

是

围绕你已经在运行的 UI 自动化工程工作流构建的 MCP 能力层

不是

测试框架、Selenium 封装、pytest 的替代品，或一个独立的 AI

这个服务器内部没有模型。 AI 模型负责推理。GenXEvo 是确定性的：它读取磁盘上真实存在的内容，之后驱动真实浏览器并执行真实测试，然后返回结构化事实。当它不知道某件事时，它会明说，并附上置信度级别。

状态 — 坦诚地说

这是 阶段 1A：基础架构加上恰好两个真正可用的能力。

已构建并测试

结果契约、错误词汇表、证据模型、不可信内容框架、配置、路径包含、机密脱敏、测试选择验证、运行模型、能力目录、能力调用器、MCP 适配器

可用的 MCP 工具

genxevo_agent_status、genxevo_discover_project

已设计、已编目、不可调用

另外 15 项能力，每项都标注了交付阶段

未构建

浏览器控制、测试执行、修复、验证

这个仓库里没有桩代码。 计划中的能力在 genxevo_agent_status 中可见，以便代理可以围绕它做规划，但未注册为工具，因此代理永远无法调用它。虚假的实现比诚实的缺失更糟糕，因为它教会代理错误的东西。

每个阶段交付什么及其退出标准，请参阅 docs/roadmap.md。

快速开始

要求

  • Python 3.11、3.12 或 3.13

  • 一个你想让代理处理的 Python 自动化项目

3.11 作为下限是工程决策，而非时尚选择：tomllib 在 3.11 进入标准库，它让项目发现无需第三方解析器即可解析 pyproject.toml。在 3.10 上则需要 tomli。参见 ADR-001。

安装

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
source .venv/bin/activate

pip install -e .

验证它能启动 — 注意横幅输出到 stderr，因为 stdout 属于 MCP 传输层：

genxevo-selenium-agent --version

连接到 MCP 客户端

复制 .mcp.json.example，并将 --workspace 指向你的自动化项目：

{
  "mcpServers": {
    "genxevo-selenium": {
      "command": "C:\\path\\to\\your\\.venv\\Scripts\\python.exe",
      "args": [
        "-m", "genxevo_selenium_agent",
        "--workspace", "C:\\path\\to\\your\\automation-project"
      ]
    }
  }
}

显式指定解释器是每个平台上最可靠的形式：控制台脚本存在于某个虚拟环境内部，而 MCP 客户端不会继承你激活的 shell。

Claude Code、VS Code 和 PyCharm 的完整说明：docs/installation.md。

配置（可选）

缺少配置文件不是错误——默认值就是安全配置。当你想更改某些内容时，将 genxevo.config.toml 放到工作区根目录：

version = 1

[execution]
enabled = false          # test execution is off until you turn it on
require_selection = true # never run the whole suite by accident

[security]
redact_secrets = true

每个设置、其默认值及其理由：docs/configuration.md。

架构

                     AI MODEL   (all reasoning lives here)
                         │  MCP · JSON-RPC over stdio
                         ▼
   ┌──────────────────────────────────────────────────────────┐
   │ genxevo_selenium_agent.mcp_server      THIN ADAPTER        │
   │ tool names · descriptions · annotations · stderr logging   │
   │ every tool function holds no logic                         │
   └──────────────────────────────────────────────────────────┘
                         │
   ┌──────────────────────────────────────────────────────────┐
   │ genxevo_selenium_agent.core            THE PRODUCT         │
   │ standard library + one typing-only shim, and nothing else  │
   │                                                            │
   │  capabilities   runtime · invoker · catalog · 2 built      │
   │  discovery      manifests · runners · venvs · page objects │
   │  security       paths · redaction · selection · globs      │
   │  contracts      ToolResult · AgentError · Evidence         │
   │  runs           RunId · RunOutcome · FileRunRegistry       │
   └──────────────────────────────────────────────────────────┘
              │                  │                  │
              ▼                  ▼                  ▼
        real project      real browser (1C)   real test runs (1D)

分层规则： 行为永远不放在适配器中。工具函数无法通过 MCP 客户端进行单元测试，因此任何可能出错的东西都不允许出现在其中。

结果契约

每项能力都返回相同的信封结构，代理根据 status 分支，绝不根据散文文本：

{
  "contractVersion": "1.0",
  "status": "partialSuccess",     // one of nine values — see below
  "operation": "project.discover",
  "summary": "…one sentence for a human…",
  "data": { },                    // shape documented per capability
  "warnings": [ { "code": "…", "message": "…", "detail": "…" } ],
  "error": null,                  // present whenever status is not succeeding
  "evidence": [ { "id": "…", "kind": "…", "trust": "trusted|untrusted", … } ],
  "nextActions": [ { "tool": "…", "reason": "…" } ],
  "durationMs": 41,
  "startedAt": "2026-08-22T09:15:00Z",
  "safeToRetry": true
}

九种状态： success · partialSuccess · failure · validationError · configurationError · blocked · timeout · cancelled · skipped

每一种都是代理需要做出的不同决策。列表中没有任何其他内容。

由于工具使用 TypedDict 进行注解，整个契约——包括 status 枚举——都会作为每个工具的 outputSchema 发布在 tools/list 中。 代理在调用任何东西之前就学会了如何读取结果。

不变量在代码中强制执行，而非靠约定：成功状态绝不携带错误，失败状态总是携带错误，status 是从错误的类别派生的，因此两者不可能不一致，而 partialSuccess 无法构造，除非有解释它的警告。

安全态势

GenXEvo 读取不可信内容，将其交给语言模型，并且将来会赋予该模型文件写入和代码执行能力。设计假设是模型最终会被说服去请求它不应拥有的东西，并且由服务器而非模型来拒绝。

控制项

作用

显式工作区根目录

从不推断。未配置即拒绝，并给出补救方法

路径包含

结构性拒绝 → 规范化 → 然后包含 → 拒绝列表 → 意图。能力接受 ResolvedPath 而非 str，因此未经验证的 I/O 无法通过类型检查

符号链接解析

Path.resolve() 在测试包含之前跟随符号链接，因此指向工作区之外的链接会被拒绝

拒绝列表

Python 感知：.pypirc、pip.conf、local_settings.py、secrets.py 以及 .env、*.pem、~/.ssh

机密脱敏

键名和值形态检测，包括 PASSWORD = "…" 这样的 Python 源码赋值

绝不执行任何项目代码

setup.py 被记录但从不运行；conftest.py 作为文本读取且从不导入；已安装包从 dist-info 目录名读取

不可信内容框架

防逃逸——载荷无法伪造任一分隔符

选择验证

以 - 开头的选择被直接拒绝：pytest -p some.module 是任意代码执行

安全默认值

执行关闭、脱敏开启、选择必需

一切皆有边界

超时、协作式取消、扫描限制、修复循环上限

运行关联

过期产物不能被当作修复证明来读取

错误卫生

任何 traceback 都不会到达代理；拒绝永远不会回显绝对工作区路径

残余风险被记录在案，而非隐藏 — 参见 SECURITY.md 和 docs/security.md。框架并不能阻止影响，测试执行按设计就是任意代码，stdio MCP 没有认证，脱敏是启发式的。

GenXEvo 家族

这是独立代理家族中的第二个产品。每个都可以单独克隆和安装；它们共享的是契约，而非构建。

Selenium

Playwright

C#

已发布

计划中

Python

本仓库

计划中

Java · JavaScript · TypeScript

计划中

计划中

跨语言移植的是 JSON 形态、九状态词汇表、错误代码、运行标识符格式、证据模型和安全类别。一个已经学会一个 GenXEvo 服务器的代理，应该在第一次接触时就能认出下一个。

不共享的是实现。本产品按设计是 Python 原生的：TypedDict 输出模式、tomllib 配置、用 dataclasses 而非序列化框架、跨 asyncio.to_thread 的协作式取消，以及围绕 pyproject.toml、pyvenv.cfg 和 pytest 自身收集规则构建的发现模型。

文档

文档

内容

docs/architecture.md

包、分层、领域模型、契约、证据、运行、并发

docs/installation.md

Claude Code、VS Code、PyCharm；解释器陷阱

docs/configuration.md

每个设置、默认值及其理由；优先级；校验

docs/mcp-tools.md

完整契约——2 个已详细实现，15 个已规划并附其保证

docs/agent-workflows.md

工程循环、代理规则、一个完整示例、反模式

docs/security.md

威胁模型、带理由的控制措施、残余风险

docs/decisions.md

架构决策记录，每条都关联到促成它的缺陷

docs/roadmap.md

阶段 1A–3，含退出标准及范围外内容

docs/troubleshooting.md

具体故障模式及其修复方法

prompts/

如何与代理对话，附完整的工作提示

examples/

可用的配置文件

开发

pip install -e ".[dev]"

ruff check .          # lint
ruff format --check . # format
mypy                  # strict type checking
pytest                # the full suite

写入 CONTRIBUTING.md 的标准：每个安全控制都附带断言攻击的测试，而不仅仅是正常路径，并且 genxevo_selenium_agent.core 只导入标准库和一个仅用于类型标注的垫片（shim）——由一项用 ast 解析每个模块的测试强制执行，而非靠约定。唯一的例外是 typing_extensions，ADR-002 解释了为什么替代方案会导致服务器在 Python 3.11 上无法启动。

作者

Rajeshkumar Muthu — 高级 QA 自动化智能体 AI 工程师。

基于 MIT 许可证 授权。

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • testing-mcp

    mcpland
    A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to write and debug integration tests by providing live access to DOM structure and executing code directly in test environments.
    5
    54
    10
    MIT

  • self-healing-browser-mcp

    RAJUSHANIGARAPU
    A
    license
    B
    quality
    C
    maintenance
    Enables AI agents to control a browser with self-healing locators that automatically recover when selectors change, allowing reliable web automation through natural language.
    7
    MIT

View all related MCP servers

Related MCP Connectors

  • Before Users Do

    Browser-backed QA with evidence and fix-ready reports for coding agents.

  • Python Code Validator

    Proves AI-generated Python does what you asked: lint, types, security, sandbox run, exact fixes.

  • ProdPoke

    AI QA tester — real browsers scan sites for bugs, SEO, perf, and accessibility issues via chat.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/genxevo/genxevo-ai-automation-agent-python-selenium'

If you have feedback or need assistance with the MCP directory API, please join our Discord server