@walkeros/mcp-source-browser 4.4.0 → 4.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +85 -0
- package/dist/index.js +1 -1
- package/package.json +12 -6
package/README.md
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
<p align="left">
|
|
2
|
+
<a href="https://www.walkeros.io">
|
|
3
|
+
<img alt="walkerOS" title="walkerOS" src="https://www.walkeros.io/img/walkerOS_logo.svg" width="256px"/>
|
|
4
|
+
</a>
|
|
5
|
+
</p>
|
|
6
|
+
|
|
7
|
+
# @walkeros/mcp-source-browser
|
|
8
|
+
|
|
9
|
+
Model Context Protocol server for walkerOS HTML tagging. Generates, parses, and
|
|
10
|
+
validates `data-elb` attributes using real DOM parsing, so an AI assistant can
|
|
11
|
+
tag a page and check its own work. Runs locally, no account or API token.
|
|
12
|
+
|
|
13
|
+
[Documentation](https://www.walkeros.io/docs/apps/mcp) •
|
|
14
|
+
[NPM Package](https://www.npmjs.com/package/@walkeros/mcp-source-browser) •
|
|
15
|
+
[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/mcps/source-browser)
|
|
16
|
+
|
|
17
|
+
## Installation
|
|
18
|
+
|
|
19
|
+
The server runs over stdio and is started by your MCP client. Add it to the
|
|
20
|
+
client's configuration:
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"mcpServers": {
|
|
25
|
+
"walkeros-source-browser": {
|
|
26
|
+
"command": "npx",
|
|
27
|
+
"args": ["@walkeros/mcp-source-browser"]
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
In Claude Code you can install the walkerOS plugin instead, which registers this
|
|
34
|
+
server along with the flow development server and the walkerOS skills:
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
/plugin marketplace add elbwalker/walkerOS
|
|
38
|
+
/plugin install walkeros@elbwalker
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
To install the binary directly:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
npm install @walkeros/mcp-source-browser
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Quick start
|
|
48
|
+
|
|
49
|
+
Ask your assistant to tag a page, for example: "Generate walkerOS tagging for a
|
|
50
|
+
product card with name and price". It calls `generate_tagging` and returns
|
|
51
|
+
ready-to-paste `data-elb` attributes.
|
|
52
|
+
|
|
53
|
+
## Tools
|
|
54
|
+
|
|
55
|
+
| Tool | Description |
|
|
56
|
+
| ------------------ | -------------------------------------------------------------------------------------------------- |
|
|
57
|
+
| `generate_tagging` | Turn structured input into `data-elb` attributes and an example HTML snippet |
|
|
58
|
+
| `parse_tagging` | Parse an HTML snippet and extract the walkerOS events and globals it produces |
|
|
59
|
+
| `validate_tagging` | Check tagging for orphan actions, missing entities, unknown triggers, and entities without actions |
|
|
60
|
+
|
|
61
|
+
All three accept an optional `prefix` to match a custom attribute prefix, which
|
|
62
|
+
defaults to `data-elb`.
|
|
63
|
+
|
|
64
|
+
## Resources
|
|
65
|
+
|
|
66
|
+
| URI | Content |
|
|
67
|
+
| ----------------------------------------- | ------------------------------------------ |
|
|
68
|
+
| `walkeros://docs/tagging/html-attributes` | Guide to `data-elb` HTML attribute tagging |
|
|
69
|
+
| `walkeros://docs/tagging/tagger` | `createTagger()` fluent API reference |
|
|
70
|
+
|
|
71
|
+
## Documentation
|
|
72
|
+
|
|
73
|
+
Full parameter tables and examples live in the docs:
|
|
74
|
+
**https://www.walkeros.io/docs/apps/mcp**
|
|
75
|
+
|
|
76
|
+
## Contribute
|
|
77
|
+
|
|
78
|
+
Feel free to contribute by submitting an
|
|
79
|
+
[issue](https://github.com/elbwalker/walkerOS/issues), starting a
|
|
80
|
+
[discussion](https://github.com/elbwalker/walkerOS/discussions), or getting in
|
|
81
|
+
[contact](https://calendly.com/elb-alexander/30min).
|
|
82
|
+
|
|
83
|
+
## License
|
|
84
|
+
|
|
85
|
+
MIT
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@walkeros/mcp-source-browser",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.5.0",
|
|
4
4
|
"description": "MCP server for walkerOS data-elb HTML tagging — generate, parse, and validate tracking attributes with real DOM parsing",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -31,16 +31,16 @@
|
|
|
31
31
|
},
|
|
32
32
|
"dependencies": {
|
|
33
33
|
"@modelcontextprotocol/sdk": "^1.26.0",
|
|
34
|
-
"@walkeros/core": "4.
|
|
35
|
-
"@walkeros/web-source-browser": "4.
|
|
34
|
+
"@walkeros/core": "4.5.0",
|
|
35
|
+
"@walkeros/web-source-browser": "4.5.0",
|
|
36
36
|
"jsdom": "^29.1.1"
|
|
37
37
|
},
|
|
38
38
|
"devDependencies": {
|
|
39
39
|
"@types/jsdom": "^28.0.3",
|
|
40
40
|
"@types/node": "^25.9.1",
|
|
41
|
-
"@walkeros/config": "4.
|
|
42
|
-
"@walkeros/collector": "4.
|
|
43
|
-
"@walkeros/web-core": "4.
|
|
41
|
+
"@walkeros/config": "4.5.0",
|
|
42
|
+
"@walkeros/collector": "4.5.0",
|
|
43
|
+
"@walkeros/web-core": "4.5.0"
|
|
44
44
|
},
|
|
45
45
|
"peerDependencies": {
|
|
46
46
|
"zod": "^4.0"
|
|
@@ -48,12 +48,18 @@
|
|
|
48
48
|
"engines": {
|
|
49
49
|
"node": ">=18.0.0"
|
|
50
50
|
},
|
|
51
|
+
"mcpName": "io.walkeros/source-browser",
|
|
51
52
|
"keywords": [
|
|
52
53
|
"walkerOS",
|
|
53
54
|
"mcp",
|
|
55
|
+
"model-context-protocol",
|
|
56
|
+
"mcp-server",
|
|
57
|
+
"ai-agents",
|
|
58
|
+
"llm",
|
|
54
59
|
"tagging",
|
|
55
60
|
"data-elb",
|
|
56
61
|
"analytics",
|
|
62
|
+
"event-tracking",
|
|
57
63
|
"html-attributes"
|
|
58
64
|
],
|
|
59
65
|
"publishConfig": {
|