Phyll

本地服务

agentphyll.com开发工具25 周前更新

代码仓库访问官网

关于 Phyll

Phyll 为 Codex、Claude Code 等支持 MCP 的 Agent 添加基于浏览器的 UX 评审工具。Agent 会测试应用核心任务并报告使用障碍，同时保留应用原有设计。

主要功能

01通过浏览器评审应用核心任务
02在桌面和手机尺寸下截图并探测页面
03扫描源码中的 AI 痕迹
04保存评审报告并提供链接
05为指定 Agent 或其他 MCP 客户端配置

适用场景

01评审应用的主要用户流程
02发现按钮失效等使用障碍
03扫描源码中的 AI 痕迹

MCP 相关

Phyll 作为 Agent 的 MCP 连接器运行，提供浏览器控制、评审、扫描、账户和升级工具。其 setup 命令可为支持的 Agent 注册连接器，也可打印其他 MCP 客户端所需的配置。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "carlosphyll-phyll": {
      "command": "npx",
      "args": [
        "-y",
        "phyll"
      ]
    }
  }
}

启动命令npx -y phyll

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmphyll0.4.6stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
url	string	是	应用运行并响应请求的地址，例如 http://localhost:3000。如果应用尚未运行，请先启动。
jobs	array	否	最终用户要完成的两三件事，按其原话填写，例如 Book a haircut。用户未提及时请省略。
name	string	否	产品名称，用于 agentphyll.com 上报告的项目名称。省略时，依次从 .phyll/config.json 和文件夹名称中获取。
user	string	否	谁会使用此应用，按用户原话填写，例如在手机上预约的理发店顾客。用户未提及时请省略。
language	string	否	报告的语言代码，例如 en 或 pt-BR。使用用户写作所用的语言。省略时，依次从项目的 .phyll/config.json 和这台计算机的语言设置中获取。
project_dir	string	否	当项目文件夹不是 Agent 运行所在的文件夹时，填写项目文件夹的路径。相对路径以该文件夹为起点。

详细介绍

phyll

在你已经使用的 Agent 中，对 AI 构建的应用进行 UX 审查。

Phyll 可接入 Codex、Claude Code 或任何支持 MCP 的 Agent。你的 Agent 会像首次使用的用户一样打开应用，在真实浏览器中完成核心任务，并撰写报告，指出妨碍使用的问题：表单索要超出任务所需的信息、注册拦截、失效按钮、难以阅读的浅色文字。修复会保留你的设计。

AI 工作在你的 Agent 中运行，使用你自己的套餐。此软件包提供浏览器、页面探测器、源码扫描器，以及连接 Phyll 引擎的接口；引擎会发送审查方法、检查报告，并将报告保存起来，同时生成一个链接。

开始

npx phyll signup [email protected]
npx phyll setup codex        # or claude, cursor, windsurf, gemini

然后询问你的 Agent：“审查我的应用：http://localhost:3000”。

setup 会在 Codex 的 config.toml 中注册连接器，通过 claude mcp add 注册，或在 Cursor 的 ~/.cursor/mcp.json、Windsurf 的 ~/.codeium/windsurf/mcp_config.json 或 Gemini CLI 的 ~/.gemini/settings.json 中注册，同时保留文件中的其他内容。它还会安装连接器所用的 Chromium 版本。对于任何其他支持 MCP 服务的 Agent，运行 npx phyll setup other 会打印可供粘贴的配置项。你需要安装 Node 20 或更高版本。

你也可以在网站上查看报告、密钥和套餐：运行 npx phyll account 即可打开已登录的账户。如果密钥丢失，请使用邮箱登录 agentphyll.com/login，然后创建一个新密钥。

命令

命令	功能
`signup <email>`	创建免费账户，可进行 5 次完整审查。密钥会保存在 `~/.phyll` 中
`login <key>`	在这台电脑上使用已有账户
`setup <agent>`	将 Phyll 接入 `codex`、`claude`、`cursor`、`windsurf` 或 `gemini`，并安装浏览器；`setup other` 会打印适用于其他 Agent 的配置
`status`	查看你的套餐和剩余审查次数
`account`	打开已登录的 agentphyll.com 账户：查看报告、用量、密钥和套餐
`pro`	订阅 Phyll Pro，每月 R$ 9，可无限次审查
`billing`	更换银行卡或取消 Phyll Pro
`scan [folder]`	扫描源码中的 AI 痕迹，无需账户或 AI。脚本可使用 `--format json`，README 徽章可使用 `--format badge`
`mcp`	为你的 Agent 运行连接器；`setup` 会为你注册连接器
`logout`	清除此电脑上的密钥

Agent 可使用的工具

start_review 会扫描项目、创建报告文件夹并返回审查方法。capture 会保存每个路由在笔记本电脑和手机屏幕尺寸下的截图及页面探测结果。open、snapshot、click、fill、select、check、press、back、screenshot、probe 和 resize 可用于操作浏览器，浏览器会停留在你的应用中。guide 会返回审查方法中的一部分，finish_review 会将报告发送到引擎并写入 report.md，而 scan、account 和 upgrade 的功能顾名思义。

哪些内容会离开你的电脑

你的源码、截图和 Agent 的对话都会留在你的电脑上。审查开始时，连接器会发送应用地址、项目名称和扫描摘要：发现了哪些痕迹、各出现多少次，以及路由和表单所在的路径。审查结束时，连接器会发送 Agent 撰写的报告；引擎会保存报告，以确保链接可用。

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Phyll

关于 Phyll

主要功能