npm - @mcp-b/global - Versions diffs - 1.0.5 → 1.0.7 - Mend

@mcp-b/global 1.0.5 → 1.0.7

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.

Files changed (6) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-b/global",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Global bundle for MCP-B with window.mcp API for script tag usage",
   "license": "MIT",
   "author": "Alex Nahas",

package/README DELETED Viewed

@@ -1,167 +0,0 @@
-# @mcp-b/global
-Global bundle for MCP-B (Model Context Protocol - Browser) that provides a polyfill exposing `window.mcp` for easy script tag or CDN usage in browser environments.
-This package creates a global MCP server instance, allowing seamless integration of Model Context Protocol capabilities directly in the browser. It's designed for scenarios where you want a drop-in polyfill without module bundlers, while also supporting modern ESM/CJS imports.
-## Features
-- Auto-initializes on script load in browsers.
-- Exposes `window.mcp` as an instance of `McpServer` from `@modelcontextprotocol/sdk`.
-- Registers a default tool: `get_current_website_title` to retrieve the document title.
-- Supports cleanup for testing or dynamic reloading.
-- Built with security in mind (e.g., configurable allowed origins for transport).
-- Lightweight and treeshaken for browser efficiency.
-## Installation
-### Via NPM (for module-based projects)
-```bash
-npm install @mcp-b/global
-```
-or
-```bash
-yarn add @mcp-b/global
-```
-or
-```bash
-pnpm add @mcp-b/global
-```
-### Via CDN (for script tag usage)
-Use a CDN like unpkg or jsDelivr for direct browser inclusion:
-```html
-<script src="https://unpkg.com/@mcp-b/global@1.0.1/dist/index.umd.js"></script>
-```
-This will auto-initialize `window.mcp` upon loading.
-## Usage
-### Script Tag (Polyfill Mode)
-Simply include the script in your HTML. The library will auto-initialize and expose `window.mcp`.
-```html
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <title>MCP-B Global Example</title>
-    <script src="https://unpkg.com/@mcp-b/global@1.0.1/dist/index.umd.js"></script>
-  </head>
-  <body>
-    <script>
-      // Wait for DOMContentLoaded if needed, but auto-init handles it
-      document.addEventListener("DOMContentLoaded", () => {
-        console.log(window.mcp); // McpServer instance
-        // Use window.mcp.registerTool(...) or other methods
-      });
-    </script>
-  </body>
-</html>
-```
-### Module Import (ESM/CJS)
-For modern JavaScript projects:
-```javascript
-// ESM
-import { initializeGlobalMCP } from "@mcp-b/global";
-// or CJS
-const { initializeGlobalMCP } = require("@mcp-b/global");
-// Initialize manually
-initializeGlobalMCP();
-// Now window.mcp is available
-console.log(window.mcp);
-```
-#### Cleanup
-If you need to reset the instance (e.g., in tests or hot module replacement):
-```javascript
-import { cleanupGlobalMCP } from "@mcp-b/global";
-cleanupGlobalMCP(); // Closes the server and removes window.mcp
-```
-## API
-### `initializeGlobalMCP(): void`
-- Initializes the global MCP server if not already done.
-- Safe to call multiple times (idempotent).
-- Throws an error if initialization fails.
-- In browser environments only; skips in non-browser contexts.
-### `cleanupGlobalMCP(): void`
-- Closes the MCP server connection.
-- Removes `window.mcp`.
-- Resets internal state for re-initialization.
-### Global Exposure
-After initialization:
-- `window.mcp`: An instance of `McpServer` with:
-  - Server info: `{ name: hostname, version: '1.0.0' }`
-  - Capabilities: Supports tool list changes and debounced notifications.
-  - Default tool: `get_current_website_title` – Returns the current document title as `{ content: [{ type: 'text', text: title }] }`.
-You can extend it by calling `window.mcp.registerTool(...)` or other MCP SDK methods.
-## Configuration and Best Practices
-- **Security**: The transport uses `allowedOrigins: ['*']` by default for broad compatibility. In production, restrict this to trusted origins (e.g., your domain) to prevent cross-origin issues. Modify the source or fork if needed.
-- **Error Handling**: Tools and initialization include try-catch blocks for robustness.
-- **Browser Compatibility**: Targets ES2018; works in modern browsers (Chrome 61+, Firefox 55+, Safari 11+, Edge 16+).
-- **TypeScript**: Includes full type declarations for `window.mcp`.
-## Dependencies
-- `@mcp-b/transports`: For browser transport handling.
-- `@modelcontextprotocol/sdk`: Core MCP SDK.
-- `zod`: For schema validation (if used internally).
-## Development
-### Building
-```bash
-pnpm install
-pnpm build
-```
-### Scripts
-- `build`: Builds the library using tsup (ESM, CJS, UMD formats).
-- `typecheck`: Runs TypeScript checks.
-- `lint` / `format` / `check`: Uses Biome for code quality.
-- `clean`: Removes build artifacts.
-## License
-MIT License. See [LICENSE](LICENSE) for details.
-## Contributing
-Contributions welcome! Fork the repo, create a branch, and submit a PR. Report issues at [GitHub Issues](https://github.com/MiguelsPizza/WebMCP/issues).
-## Links
-- [Repository](https://github.com/MiguelsPizza/WebMCP/tree/main/packages/global)
-- [NPM Package](https://www.npmjs.com/package/@mcp-b/global)
-- [Homepage](https://github.com/MiguelsPizza/WebMCP#readme)