@mcp-b/global 1.1.3-beta.2 → 1.1.3-beta.3
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 +51 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.iife.js +7 -5
- package/dist/index.js +52 -15
- package/dist/index.js.map +1 -1
- package/package.json +26 -10
package/README.md
CHANGED
|
@@ -1,11 +1,35 @@
|
|
|
1
1
|
# @mcp-b/global
|
|
2
2
|
|
|
3
|
-
> Web Model Context API polyfill -
|
|
3
|
+
> W3C Web Model Context API polyfill - Let Claude, ChatGPT, Gemini, and other AI agents interact with your website
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/@mcp-b/global)
|
|
6
|
+
[](https://www.npmjs.com/package/@mcp-b/global)
|
|
6
7
|
[](https://opensource.org/licenses/MIT)
|
|
8
|
+
[](https://bundlephobia.com/package/@mcp-b/global)
|
|
9
|
+
[](https://github.com/nicolo-ribaudo/model-context-protocol-api)
|
|
7
10
|
|
|
8
|
-
|
|
11
|
+
📖 **[Full Documentation](https://docs.mcp-b.ai/packages/global)** | 🚀 **[Quick Start](https://docs.mcp-b.ai/quickstart)** | 🔧 **[Tool Registration](https://docs.mcp-b.ai/concepts/tool-registration)**
|
|
12
|
+
|
|
13
|
+
**@mcp-b/global** implements the [W3C Web Model Context API](https://github.com/nicolo-ribaudo/model-context-protocol-api) (`navigator.modelContext`) specification, allowing AI agents like Claude, ChatGPT, Gemini, Cursor, and Copilot to discover and call functions on your website.
|
|
14
|
+
|
|
15
|
+
## Why Use @mcp-b/global?
|
|
16
|
+
|
|
17
|
+
| Feature | Benefit |
|
|
18
|
+
|---------|---------|
|
|
19
|
+
| **W3C Standard** | Implements the emerging Web Model Context API specification |
|
|
20
|
+
| **Drop-in IIFE** | Add AI capabilities with a single `<script>` tag - no build step |
|
|
21
|
+
| **Native Chromium Support** | Auto-detects and uses native browser implementation when available |
|
|
22
|
+
| **Dual Transport** | Works with both same-window clients AND parent pages (iframe support) |
|
|
23
|
+
| **Two-Bucket System** | Manage app-level and component-level tools separately |
|
|
24
|
+
| **Works with Any AI** | Claude, ChatGPT, Gemini, Cursor, Copilot, and any MCP client |
|
|
25
|
+
|
|
26
|
+
## Use Cases
|
|
27
|
+
|
|
28
|
+
- **AI-Powered Websites**: Let AI agents search, filter, and interact with your web app
|
|
29
|
+
- **E-commerce Integration**: AI can search products, add to cart, checkout
|
|
30
|
+
- **SaaS Applications**: Expose your app's functionality to AI assistants
|
|
31
|
+
- **Content Management**: Let AI edit, publish, and organize content
|
|
32
|
+
- **Embedded Widgets**: AI tools accessible from parent pages via iframes
|
|
9
33
|
|
|
10
34
|
## 🚀 Quick Start
|
|
11
35
|
|
|
@@ -1121,17 +1145,38 @@ Always validate inputs in your tool implementations:
|
|
|
1121
1145
|
}
|
|
1122
1146
|
```
|
|
1123
1147
|
|
|
1148
|
+
## Frequently Asked Questions
|
|
1149
|
+
|
|
1150
|
+
### How do AI agents connect to my website?
|
|
1151
|
+
|
|
1152
|
+
AI agents connect through browser extensions or the `@mcp-b/chrome-devtools-mcp` server, which bridges desktop AI clients to browser-based tools.
|
|
1153
|
+
|
|
1154
|
+
### Do I need a build step?
|
|
1155
|
+
|
|
1156
|
+
No! Use the IIFE version with a single `<script>` tag. For bundler users, the ESM version is also available.
|
|
1157
|
+
|
|
1158
|
+
### Is this production-ready?
|
|
1159
|
+
|
|
1160
|
+
Yes! The polyfill handles tool registration, lifecycle management, and automatically uses native Chromium implementation when available.
|
|
1161
|
+
|
|
1162
|
+
### What about browser support?
|
|
1163
|
+
|
|
1164
|
+
Works in all modern browsers. Native API support is available in Chromium with experimental flags enabled.
|
|
1165
|
+
|
|
1124
1166
|
## 🤝 Related Packages
|
|
1125
1167
|
|
|
1126
|
-
- [`@mcp-b/transports`](
|
|
1127
|
-
- [`@mcp-b/
|
|
1168
|
+
- [`@mcp-b/transports`](https://docs.mcp-b.ai/packages/transports) - MCP transport implementations
|
|
1169
|
+
- [`@mcp-b/react-webmcp`](https://docs.mcp-b.ai/packages/react-webmcp) - React hooks for MCP
|
|
1170
|
+
- [`@mcp-b/extension-tools`](https://docs.mcp-b.ai/packages/extension-tools) - Chrome Extension API tools
|
|
1171
|
+
- [`@mcp-b/chrome-devtools-mcp`](https://docs.mcp-b.ai/packages/chrome-devtools-mcp) - Connect desktop AI agents to browser tools
|
|
1128
1172
|
- [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk) - Official MCP SDK
|
|
1129
1173
|
|
|
1130
1174
|
## 📚 Resources
|
|
1131
1175
|
|
|
1132
|
-
- [
|
|
1176
|
+
- [WebMCP Documentation](https://docs.mcp-b.ai)
|
|
1177
|
+
- [Web Model Context API Explainer](https://github.com/nicolo-ribaudo/model-context-protocol-api)
|
|
1133
1178
|
- [Model Context Protocol Spec](https://modelcontextprotocol.io/)
|
|
1134
|
-
- [
|
|
1179
|
+
- [MCP GitHub Repository](https://github.com/modelcontextprotocol)
|
|
1135
1180
|
|
|
1136
1181
|
## 📝 License
|
|
1137
1182
|
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/global.ts","../src/validation.ts"],"sourcesContent":[],"mappings":";;;;;;AA2eA;;;;;;;;;;;;;;AAoCA;;;;;;;AAkBiB,UAjbA,WAAA,CAibY;EAMd;EAEE,IAAA,EAAA,MAAA;EAED;EAAe,UAAA,CAAA,EAvbhB,MAubgB,CAAA,MAAA,EAAA;IAOd;IAeA,IAAA,EAAA,MAAA;IAaA;IAOT,WAAA,CAAA,EAAA,MAAA;IALI;IAkBI,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;EASH,CAAA,CAAA;EAAM;EAOF,QAAA,CAAA,EAAA,MAAc,EAAA;EAcd;EA+BA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;AAejB;AAKA;AAeA;;;;;AAuBA;;;;;AAqBA;;;;;AAiB4C,KA1mBhC,eAAA,GAAkB,MA0mBc,CAAA,MAAA,EA1mBC,CAAA,CAAE,UA0mBH,CAAA;;;;;;AA0FI,KA/qBpC,YAAA,GAAe,cA+qBqB;;;;;;;;;;;;AA+DhD;;;;;;;;;;;AAyBA;AAEa,UA5uBI,sBAAA,CA4uBJ;EAEI;;;;EAIJ,MAAA,CAAA,EAAA,GAAA,GA7uBI,SA6uBJ;EAEU;;;;;EAiBN,SAAA,CAAA,EAzvBH,OAyvBW,CAzvBH,yBAyvBG,CAAA,GAAA,KAAA;EAqBR;;;;;EA0CiC,YAAA,CAAA,EAjzBjC,OAizBiC,CAjzBzB,2BAizByB,CAAA,GAAA,KAAA;;;;AA0BjD;;;;;;;;;;;UA3zBgB,0BAAA;EC9LG;;;EAKqC,SAAA,CAAA,ED6L3C,sBC7L2C;EAAA;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/global.ts","../src/validation.ts"],"sourcesContent":[],"mappings":"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"}
|