关于 walkerOS Source Browser
面向为页面添加事件属性的团队的本地 MCP 服务,用于创建和检查 walkerOS HTML 标记。它通过 DOM 解析生成、提取和验证 `data-elb` 属性,无需账号或 API 令牌。
主要功能
- 01生成 `data-elb` 属性和 HTML
- 02解析 HTML 片段中的标记
- 03验证标记结构
- 04支持自定义属性前缀
适用场景
- 01为商品卡片添加 walkerOS 标记
- 02从 HTML 中提取事件和全局变量
- 03检查页面中不完整或未知的标记
MCP 相关
向 MCP 客户端提供三个标记工具和两个文档资源:`generate_tagging`、`parse_tagging` 和 `validate_tagging`。服务通过 stdio 在本地运行,无需账号或 API 令牌。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data | object | 否 | 以 key:value 键值对形式提供实体属性 |
| link | object | 否 | 用于 data-elblink 的链接关系(id:type,例如 {"details":"parent"}) |
| action | object | 否 | 用于 data-elbaction 的触发器:操作对(仅最近的实体) |
| entity | string | 否 | 实体名称(创建 data-elb="entity",并限定 data-elb-entity 属性的作用范围) |
| prefix | string | 否 | 自定义前缀(默认值:data-elb) |
| scoped | object | 否 | data-elb_ 的路径限定通用属性(仅此元素下方嵌套的触发器会接收这些属性) |
| actions | object | 否 | data-elbactions 的触发器-操作对(所有实体) |
| context | object | 否 | data-elbcontext 的上下文属性 |
| globals | object | 否 | data-elbglobals 的全局属性 |
详细介绍
@walkeros/mcp-source-browser
用于 walkerOS HTML 标记的 Model Context Protocol 服务。使用真实 DOM 解析生成、解析并验证 data-elb 属性,让 AI 助手能够为页面添加标记并检查自己的工作。在本地运行,无需账户或 API 令牌。
安装
该服务通过 stdio 运行,并由 MCP 客户端启动。将其添加到客户端的配置中:
{
"mcpServers": {
"walkeros-source-browser": {
"command": "npx",
"args": ["@walkeros/mcp-source-browser"]
}
}
}
在 Claude Code 中,也可以安装 walkerOS 插件,它会注册此服务,以及 flow 开发服务和 walkerOS 技能:
/plugin marketplace add elbwalker/walkerOS
/plugin install walkeros@elbwalker
要直接安装二进制文件:
npm install @walkeros/mcp-source-browser
快速开始
让助手为页面添加标记,例如:“为一个包含名称和价格的商品卡片生成 walkerOS 标记”。它会调用 generate_tagging,并返回可直接粘贴的 data-elb 属性。
工具
| 工具 | 描述 |
|---|---|
generate_tagging | 将结构化输入转换为 data-elb 属性和示例 HTML 代码片段 |
parse_tagging | 解析 HTML 代码片段,并提取由此生成的 walkerOS 事件和全局变量 |
validate_tagging | 检查标记中是否存在孤立操作、缺失实体、未知触发器,以及没有操作的实体 |
这三个工具都接受可选的 prefix,用于匹配自定义属性前缀,默认值为 data-elb。
资源
| URI | 内容 |
|---|---|
walkeros://docs/tagging/html-attributes | data-elb HTML 属性标记指南 |
walkeros://docs/tagging/tagger | createTagger() 流式 API 参考 |
文档
完整的参数表和示例请参阅文档: https://www.walkeros.io/docs/apps/mcp
贡献
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。