feat: add MCP command-line scripts and enhance logging functionality with new HTTP transport options

Author: regenrek

.cursor/mcp.json

@@ -1,7 +1,8 @@
 {
   "mcpServers": {
     "browser-echo": {
-      "url": "http://localhost:5173/__mcp"
+      "type": "http",
+      "url": "http://localhost:5179/mcp"
     }
   }
 }

example/react-vite-app/vite.config.ts

@@ -4,5 +4,10 @@ import browserEcho from '@browser-echo/vite'
 
 // https://vite.dev/config/
 export default defineConfig({
-  plugins: [react(), browserEcho({ stackMode: 'condensed' })],
+  plugins: [react(), browserEcho({ 
+    stackMode: 'condensed',
+    // mcp: {
+    //   url: 'http://localhost:5179'
+    // }
+  })],
 })

package.json

@@ -9,7 +9,11 @@
     "cleanup": "pnpm tsx scripts/cleanup.ts",
     "test": "vitest run --reporter=dot",
     "test:watch": "vitest",
-    "lint": "eslint ."
+    "lint": "eslint .",
+    "mcp": "node packages/mcp/dist/cli.mjs",
+    "mcp:port": "node packages/mcp/dist/cli.mjs --port",
+    "mcp:dev": "pnpm tsx packages/mcp/src/index.ts",
+    "mcp:build": "pnpm --filter @browser-echo/mcp run build"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

packages/mcp/README.md

@@ -4,11 +4,12 @@ MCP (Model Context Protocol) server for Browser Echo - captures and exposes fron
 
 ## Overview
 
-This package provides an MCP server that:
+This package provides an MCP server using Streamable HTTP transport that:
 - Captures frontend console logs (errors, warnings, info, debug)
 - Exposes logs through MCP tools and resources for AI assistants
 - Enables debugging of React hydration issues, network failures, and other frontend problems
 - Supports session-based filtering and soft/hard log clearing
+- Runs on HTTP transport for compatibility with browser-based log forwarding
 
 ## Installation
 
@@ -18,7 +19,19 @@ pnpm add -D @browser-echo/mcp
 
 ## Usage
 
-The MCP server is automatically started when using Browser Echo with supported frameworks (Vite, Next.js, Nuxt).
+Start the MCP server:
+
+```bash
+# Start on default port 5179
+pnpm --package=@browser-echo/mcp dlx browser-echo-mcp
+
+# Or with custom port
+pnpm --package=@browser-echo/mcp dlx browser-echo-mcp --port 8080
+```
+
+The server exposes:
+- MCP endpoint at `http://localhost:5179/mcp`
+- Log ingestion at `http://localhost:5179/__client-logs`
 
 ### Available Tools
 
@@ -116,8 +129,8 @@ The server also exposes logs as MCP resources:
 
 ### Environment Variables
 
-- `BROWSER_ECHO_MCP=0` - Disable MCP server (enabled by default in development)
-- `NODE_ENV=production` - MCP is automatically disabled in production
+- `BROWSER_ECHO_MCP_URL` - Override the default MCP server URL
+- `BROWSER_ECHO_BUFFER_SIZE` - Maximum log entries to keep in memory (default: 1000)
 
 ## API
 
@@ -155,7 +168,17 @@ publishLogEntry({
 
 ## Integration with AI Assistants
 
-The MCP server is designed to work seamlessly with AI assistants like Claude (via Cursor) or other MCP-compatible tools.
+The MCP server works with any MCP-compatible client. For Cursor, add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "browser-echo": {
+      "url": "http://localhost:5179/mcp"
+    }
+  }
+}
+```
 
 ### Natural Language Commands
 

packages/mcp/bin/cli.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'node:url'
+import { runMain } from '../dist/index.mjs'
+
+globalThis.__mcp_starter_cli__ = {
+  startTime: Date.now(),
+  entry: fileURLToPath(import.meta.url),
+}
+
+runMain()

packages/mcp/build.config.ts

@@ -4,7 +4,12 @@ export default defineBuildConfig({
   entries: ['./src/index'],
   clean: true,
   declaration: true,
+  failOnWarn: false,
+  externals: [
+    '@modelcontextprotocol/sdk',
+  ],
   rollup: {
     emitCJS: false,
+    inlineDependencies: false,
   },
 });