@extension.dev/mcp 4.1.0 → 4.1.1
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/CHANGELOG.md +8 -0
- package/README.md +65 -92
- package/dist/module.js +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 4.1.1
|
|
4
|
+
|
|
5
|
+
README rewritten for the public npm page: Extension.js-style header
|
|
6
|
+
(badges, tagline, quick start), tool table updated to the full 27-tool
|
|
7
|
+
surface (release-promote was missing), and links to private repos or
|
|
8
|
+
npm-restricted packages removed. Package description tool count fixed
|
|
9
|
+
(26 -> 27). No code changes.
|
|
10
|
+
|
|
3
11
|
## 4.1.0
|
|
4
12
|
|
|
5
13
|
The MCP now consumes `@extension.dev/core` for all platform-auth logic
|
package/README.md
CHANGED
|
@@ -1,48 +1,37 @@
|
|
|
1
|
-
[npm-version-image]: https://img.shields.io/npm/v/%40extension.dev%2Fmcp
|
|
1
|
+
[npm-version-image]: https://img.shields.io/npm/v/%40extension.dev%2Fmcp.svg?color=0971fe
|
|
2
2
|
[npm-version-url]: https://www.npmjs.com/package/@extension.dev/mcp
|
|
3
|
-
[
|
|
4
|
-
[
|
|
3
|
+
[npm-downloads-image]: https://img.shields.io/npm/dm/%40extension.dev%2Fmcp.svg?color=0971fe
|
|
4
|
+
[npm-downloads-url]: https://www.npmjs.com/package/@extension.dev/mcp
|
|
5
|
+
[discord-image]: https://img.shields.io/discord/1253608412890271755?label=Discord&logo=discord&style=flat&color=0971fe
|
|
6
|
+
[discord-url]: https://discord.gg/v9h2RgeTSN
|
|
5
7
|
|
|
6
|
-
[![Version][npm-version-image]][npm-version-url] [![
|
|
8
|
+
# @extension.dev/mcp [![Version][npm-version-image]][npm-version-url] [![Downloads][npm-downloads-image]][npm-downloads-url] [![Discord][discord-image]][discord-url]
|
|
7
9
|
|
|
8
|
-
|
|
10
|
+
> Give your AI agent hands for browser extension development. 27 MCP tools that scaffold, run, inspect, debug, and publish cross-browser extensions.
|
|
9
11
|
|
|
10
|
-
|
|
12
|
+
<img alt="Logo" align="right" src="https://avatars.githubusercontent.com/u/106714027" width="20%" />
|
|
11
13
|
|
|
12
14
|
```bash
|
|
13
15
|
claude mcp add extension-dev npx @extension.dev/mcp
|
|
14
16
|
```
|
|
15
17
|
|
|
16
|
-
|
|
18
|
+
Works with Claude Code, Claude Desktop, Cursor, and any MCP client.
|
|
17
19
|
|
|
18
|
-
|
|
20
|
+
[extension.dev](https://extension.dev) · [Documentation](https://extension.js.org) · [Templates](https://templates.extension.dev) · [Examples](https://github.com/extension-js/examples) · [Discord](https://discord.gg/v9h2RgeTSN)
|
|
19
21
|
|
|
20
|
-
|
|
21
|
-
@extension.dev/mcp
|
|
22
|
-
src/ MCP server source (26 tools)
|
|
23
|
-
claude/ Claude Code integration (CLAUDE.md, slash commands, rules)
|
|
24
|
-
bin/ CLI entrypoint
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
**MCP server**: programmatic bridge between AI assistants and the extension.dev platform. Imports from published npm packages:
|
|
22
|
+
## Why an MCP server for extensions
|
|
28
23
|
|
|
29
|
-
|
|
30
|
-
- `extension-develop`: build/dev/preview
|
|
31
|
-
- `extension-install`: managed browser binaries
|
|
24
|
+
Extensions fail silently: content scripts that never inject, panels that never open, permissions that return `undefined` with no error. An agent editing files blind will happily "fix" all of them without noticing none of them work.
|
|
32
25
|
|
|
33
|
-
|
|
26
|
+
These tools give agents eyes on the live browser, so they debug from evidence instead of guessing:
|
|
34
27
|
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
28
|
+
- **Scaffold** from the 60+ template catalog behind [templates.extension.dev](https://templates.extension.dev), or add a popup, sidebar, or content script to an existing project
|
|
29
|
+
- **Run** the dev server with HMR in Chrome, Edge, Firefox, or any managed browser binary, no build config
|
|
30
|
+
- **See** the live DOM, unified logs from every extension context, `chrome.storage` contents, and the loaded-extension list
|
|
31
|
+
- **Act**: evaluate code in any context, trigger the action button and commands, reload the extension, replay events
|
|
32
|
+
- **Ship**: validate the manifest cross-browser, build for production, publish a shareable preview, and promote builds to release channels headlessly
|
|
38
33
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
```bash
|
|
42
|
-
mkdir -p .claude/skills && cp -R node_modules/@extension.dev/skill/skills/extension-dev .claude/skills/
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
Browser-launching tools (`dev`, `start`, `preview`) shell out to the `extension` CLI since they require the full browser launcher infrastructure.
|
|
34
|
+
Built on [Extension.js](https://extension.js.org), the open-source cross-browser extension framework.
|
|
46
35
|
|
|
47
36
|
## Setup
|
|
48
37
|
|
|
@@ -52,7 +41,7 @@ Browser-launching tools (`dev`, `start`, `preview`) shell out to the `extension`
|
|
|
52
41
|
claude mcp add extension-dev npx @extension.dev/mcp
|
|
53
42
|
```
|
|
54
43
|
|
|
55
|
-
### Claude Desktop /
|
|
44
|
+
### Claude Desktop / `.mcp.json`
|
|
56
45
|
|
|
57
46
|
```json
|
|
58
47
|
{
|
|
@@ -65,79 +54,63 @@ claude mcp add extension-dev npx @extension.dev/mcp
|
|
|
65
54
|
}
|
|
66
55
|
```
|
|
67
56
|
|
|
68
|
-
### Claude Code integration
|
|
57
|
+
### Claude Code project integration
|
|
69
58
|
|
|
70
|
-
|
|
59
|
+
The package ships drop-in instructions, slash commands, and rules for extension projects:
|
|
71
60
|
|
|
72
61
|
```bash
|
|
73
62
|
# Rules (how Claude understands your project)
|
|
74
63
|
cp node_modules/@extension.dev/mcp/claude/CLAUDE.md ~/my-extension/.claude/CLAUDE.md
|
|
75
64
|
|
|
76
|
-
# Slash commands
|
|
65
|
+
# Slash commands (/extension, /extension-add, /extension-debug, /extension-publish)
|
|
77
66
|
mkdir -p ~/my-extension/.claude/commands
|
|
78
67
|
cp node_modules/@extension.dev/mcp/claude/commands/*.md ~/my-extension/.claude/commands/
|
|
79
68
|
```
|
|
80
69
|
|
|
81
70
|
## Tools
|
|
82
71
|
|
|
83
|
-
| Tier | Tool
|
|
84
|
-
| ---- |
|
|
85
|
-
|
|
|
86
|
-
|
|
|
87
|
-
|
|
|
88
|
-
|
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
|
94
|
-
|
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
99
|
-
|
|
|
100
|
-
| act
|
|
101
|
-
| act
|
|
102
|
-
| act
|
|
103
|
-
| act
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
NPM_TOKEN=<token> pnpm publish
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
Uses `prepublishOnly` to run tests and compile before publishing.
|
|
128
|
-
|
|
129
|
-
## The extension.dev open source stack
|
|
130
|
-
|
|
131
|
-
| Package | Use it to |
|
|
132
|
-
| --- | --- |
|
|
133
|
-
| [`@extension.dev/skill`](https://github.com/extensiondev/skill) | Teach agents the cross-browser rules and silent-failure gotchas |
|
|
134
|
-
| [`@extension.dev/deploy`](https://github.com/extensiondev/deploy) | Ship to Chrome, Firefox, and Edge stores from CI |
|
|
135
|
-
| [`@extension.dev/artifact-integrity`](https://github.com/extensiondev/artifact-integrity) | Gate releases on artifact verification |
|
|
136
|
-
| [`@extension.dev/compiler`](https://github.com/extensiondev/compiler) | Build extensions in the browser with esbuild-wasm |
|
|
137
|
-
| [`@extension.dev/core`](https://github.com/extensiondev/core) | Authenticate and publish to the extension.dev platform |
|
|
138
|
-
|
|
139
|
-
All of it rides on [Extension.js](https://github.com/extension-js/extension.js), the open-source cross-browser extension framework.
|
|
72
|
+
| Tier | Tool | Description |
|
|
73
|
+
| ---- | ---- | ----------- |
|
|
74
|
+
| build | `extension_create` | Scaffold from a template |
|
|
75
|
+
| build | `extension_list_templates` | Browse 60+ templates |
|
|
76
|
+
| build | `extension_get_template_source` | Read template source files |
|
|
77
|
+
| build | `extension_add_feature` | Add sidebar/popup/content script |
|
|
78
|
+
| build | `extension_build` | Build for production |
|
|
79
|
+
| run | `extension_dev` | Dev server with HMR |
|
|
80
|
+
| run | `extension_start` | Build + preview |
|
|
81
|
+
| run | `extension_preview` | Preview the production build |
|
|
82
|
+
| run | `extension_wait` | Poll the dev-server ready contract |
|
|
83
|
+
| see | `extension_manifest_validate` | Cross-browser manifest validation |
|
|
84
|
+
| see | `extension_inspect` | Build output analysis |
|
|
85
|
+
| see | `extension_source_inspect` | Live DOM inspection (CDP) |
|
|
86
|
+
| see | `extension_dom_inspect` | CDP-free DOM snapshot |
|
|
87
|
+
| see | `extension_list_extensions` | List loaded extensions (Chromium) |
|
|
88
|
+
| see | `extension_logs` | Stream logs from every context |
|
|
89
|
+
| act | `extension_eval` | Evaluate in a context (`--allow-eval`) |
|
|
90
|
+
| act | `extension_storage` | Read/write `chrome.storage` |
|
|
91
|
+
| act | `extension_reload` | Reload extension or tab |
|
|
92
|
+
| act | `extension_open` | Open a surface / trigger `action`, `command` |
|
|
93
|
+
| browsers | `extension_install_browser` | Install a managed browser binary |
|
|
94
|
+
| browsers | `extension_list_browsers` | List managed browsers |
|
|
95
|
+
| browsers | `extension_detect_browsers` | Detect system browsers |
|
|
96
|
+
| platform | `extension_login` | GitHub device-code login, stored token |
|
|
97
|
+
| platform | `extension_whoami` | Show the stored login (never the token) |
|
|
98
|
+
| platform | `extension_logout` | Remove stored credentials |
|
|
99
|
+
| platform | `extension_publish` | Publish a shareable preview to extension.dev |
|
|
100
|
+
| platform | `extension_release_promote` | Promote a build to a release channel, headless |
|
|
101
|
+
|
|
102
|
+
Browser-launching tools (`dev`, `start`, `preview`) shell out to the `extension` CLI; everything else runs in-process.
|
|
103
|
+
|
|
104
|
+
## From preview to store
|
|
105
|
+
|
|
106
|
+
The four platform tools connect agents to [extension.dev](https://extension.dev): `extension_login` runs a GitHub device-code flow and stores a project-scoped token locally (never returned to the agent), `extension_publish` turns a build into a shareable preview URL, and `extension_release_promote` promotes a tested build to a release channel from CI or an agent session, no browser required. To automate store submission itself (Chrome Web Store, Edge Add-ons, Firefox AMO), pair with [`@extension.dev/deploy`](https://www.npmjs.com/package/@extension.dev/deploy).
|
|
107
|
+
|
|
108
|
+
## Community
|
|
109
|
+
|
|
110
|
+
- Join the [Discord](https://discord.gg/v9h2RgeTSN) for help and feedback
|
|
111
|
+
- Browse production-ready [examples](https://github.com/extension-js/examples)
|
|
112
|
+
- Report Extension.js framework issues on [GitHub](https://github.com/extension-js/extension.js/issues)
|
|
140
113
|
|
|
141
114
|
## License
|
|
142
115
|
|
|
143
|
-
MIT
|
|
116
|
+
MIT (c) Cezar Augusto and the Extension.js authors.
|
package/dist/module.js
CHANGED
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@extension.dev/mcp",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "4.1.
|
|
5
|
-
"description": "MCP server that lets AI agents build, run, inspect, and publish browser extensions.
|
|
4
|
+
"version": "4.1.1",
|
|
5
|
+
"description": "MCP server that lets AI agents build, run, inspect, and publish browser extensions. 27 tools for scaffolding, live DOM inspection, log streaming, and store-ready builds across Chrome, Edge, and Firefox.",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"author": {
|
|
8
8
|
"name": "Cezar Augusto",
|