goflag

本地服务

goflag.tech商业与营销12 天前更新

关于 goflag

@goflag/mcp 是供 Agent 审查开发中网站 SEO 和国际化情况的本地 MCP 服务。它检查本地或可访问的预览网址，附上规则来源报告问题，并可与已保存的基线比较结果。

提供 audit_site、compare_to_baseline、explain_rule 和 list_rules 四种只读 MCP 工具。它通过 stdio 在本地运行，不会启动命令、写入基线或提供远程模式。

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

mcp.json · 通用配置

{
  "mcpServers": {
    "tancredesimonin-goflag": {
      "command": "npx",
      "args": [
        "-y",
        "@goflag/mcp"
      ]
    }
  }
}

启动命令npx -y @goflag/mcp

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

安装包

npm@goflag/mcp0.1.2stdio

收录的工具列表 · 更新于 1 天前

参数	类型	必填	说明
url	string	是	要审计的站点，使用 HTTP 或 HTTPS。开发服务器的 URL 也可以：http://localhost:3000。
static	boolean	否	绝不启动 Chromium；仅评估服务器渲染的 HTML。
locales	array	否	站点提供的语言区域，例如 ["en", "fr"]，当站点地图未提供这些信息时使用。
maxPages	integer	否	页面数量上限。默认值为 50。
advisories	boolean	否	同时返回代码检查工具无法判定的问题及其依据，供你评估。
checkExternal	boolean	否	同时检查指向其他站点的链接。默认关闭：速度较慢，而且问题并非由你的网站导致。
expectIndexing	enum	否	对于必须排除在搜索索引之外的暂存或预览主机，设置为 "no"。no \| yes

将 goflag 用作 MCP 服务。Agent 会审核它正在编辑的网站——无论是 localhost 上的开发服务器，还是 VPN 后面的预览站点——并查看每条规则及其所依据的文档。

它在本地通过 stdio 运行，与 @goflag/cli 使用相同的引擎：这里给出的答案，就是 goflag 会打印的答案。

Claude Code：

claude mcp add goflag -- npx -y @goflag/mcp

Cursor（.cursor/mcp.json）、VS Code（servers 下的 .vscode/mcp.json）和其他客户端使用相同的命令：

{
  "mcpServers": {
    "goflag": { "command": "npx", "args": ["-y", "@goflag/mcp"] }
  }
}

然后让 Agent 检查刚刚修改内容的 SEO：它会启动开发服务器，对其 URL 调用 audit_site，修复新发现的问题，再次调用该工具。

这四个工具都为只读工具：不会向磁盘或网站写入任何内容。

工具	输入	返回内容
`audit_site`	`url`；可选参数 `maxPages`（默认值为 50）、`locales`、`expectIndexing`、`static`、`advisories`、`checkExternal`（默认关闭）	按规则汇总的发现结果及其严格程度、翻译缺漏、失效链接、覆盖情况，以及 CLI 会返回的退出码
`compare_to_baseline`	相同参数，外加 `baseline`：由 `goflag --report` 或 `--update-baseline` 保存的 JSON 报告	新增的问题、已解决的问题，以及未变化的问题数量
`explain_rule`	来自某条发现结果的 `id`	规则的检查内容、原因、严格程度、相关文档，以及它在 goflag.tech 上的页面
`list_rules`	可选的 `scope`：`page`、`site` 或 `prose`	每条规则及其适用范围、严重程度和严格程度

如果客户端请求报告爬取进度，audit_site 会报告进度；调用取消时，它会停止。

不支持请求头。 作为工具参数传入的令牌会出现在 Agent 的对话记录中。请使用 CLI 审核受保护的预览站点：goflag <url> --header "<name>: <value>"。
不会运行命令。 Agent 会启动自己的开发服务器；此服务不会执行任何命令。
不会写入基线。 使用 goflag <url> --update-baseline --baseline .goflag/baseline.json 保存基线；compare_to_baseline 只会读取基线，并会拒绝不含原文引用的非 goflag 报告文件。
不支持远程模式。 它在 Agent 所在的位置运行，因此能够访问 localhost。