feat: move from mcp to cli

package.json

@@ -1,13 +1,13 @@
 {
   "name": "@metamask/client-mcp-core",
   "version": "0.1.1",
-  "description": "MCP server for MetaMask Extension visual testing with LLM agents",
+  "description": "HTTP daemon and CLI for agent-driven browser extension testing with Playwright",
   "keywords": [
-    "mcp",
     "playwright",
     "llm",
     "visual-testing",
-    "browser-extension"
+    "browser-extension",
+    "cli"
   ],
   "homepage": "https://github.com/MetaMask/client-mcp-core#readme",
   "bugs": {
@@ -35,6 +35,9 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.cts",
+  "bin": {
+    "mm": "./dist/cli/mm.cjs"
+  },
   "files": [
     "dist"
   ],
@@ -57,7 +60,8 @@
     "@isaacs/brace-expansion": "5.0.1"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
+    "cosmiconfig": "^9.0.0",
+    "express": "^5.2.1",
     "zod": "^4.3.5"
   },
   "devDependencies": {
@@ -71,6 +75,7 @@
     "@metamask/eslint-config-vitest": "^15.0.0",
     "@playwright/test": "^1.49.0",
     "@ts-bridge/cli": "^0.6.3",
+    "@types/express": "^5.0.6",
     "@types/node": "^20.0.0",
     "@typescript-eslint/utils": "^8.6.0",
     "@vitest/coverage-istanbul": "^3.0.7",

scripts/prepack.sh

@@ -9,3 +9,5 @@ if [[ -n $SKIP_PREPACK ]]; then
 fi
 
 yarn build
+
+chmod +x dist/cli/mm.cjs

src/capabilities/context.test.ts

@@ -20,7 +20,6 @@ describe('isE2EConfig', () => {
       environment: 'e2e',
       extensionName: 'MetaMask',
       defaultPassword: 'password123',
-      toolPrefix: 'mm',
       artifactsDir: './test-artifacts',
       defaultChainId: 1337,
       ports: {
@@ -54,7 +53,6 @@ describe('isE2EConfig', () => {
       environment: 'prod',
       extensionName: 'MetaMask',
       defaultPassword: 'password123',
-      toolPrefix: 'mm',
       defaultChainId: 1,
     };
 
@@ -93,7 +91,6 @@ describe('isProdConfig', () => {
       environment: 'prod',
       extensionName: 'MetaMask',
       defaultPassword: 'password123',
-      toolPrefix: 'mm',
       artifactsDir: './artifacts',
       defaultChainId: 1,
     };
@@ -119,7 +116,6 @@ describe('isProdConfig', () => {
       environment: 'e2e',
       extensionName: 'MetaMask',
       defaultPassword: 'password123',
-      toolPrefix: 'mm',
       artifactsDir: './test-artifacts',
       defaultChainId: 1337,
       ports: {
@@ -438,3 +434,34 @@ describe('hasCapability', () => {
     expect(hasCapability(context, 'mockServer')).toBe(true);
   });
 });
+
+describe('WorkflowContext with allocatedPorts', () => {
+  it('accepts allocatedPorts with port mappings', () => {
+    const context: WorkflowContext = {
+      config: {
+        environment: 'e2e',
+        extensionName: 'MetaMask',
+      },
+      allocatedPorts: {
+        anvil: 3000,
+        fixture: 4000,
+      },
+    };
+
+    expect(context.allocatedPorts).toStrictEqual({
+      anvil: 3000,
+      fixture: 4000,
+    });
+  });
+
+  it('allows WorkflowContext without allocatedPorts (field is optional)', () => {
+    const context: WorkflowContext = {
+      config: {
+        environment: 'e2e',
+        extensionName: 'MetaMask',
+      },
+    };
+
+    expect(context.allocatedPorts).toBeUndefined();
+  });
+});

src/capabilities/context.ts

@@ -7,6 +7,9 @@ import type {
   MockServerCapability,
 } from './types.js';
 
+/** Sparse port-name → port-number map. `Partial` ensures lookups resolve to `number | undefined`. */
+export type PortMap = Partial<Record<string, number>>;
+
 /**
  * Environment mode discriminator.
  * - 'e2e': End-to-end testing environment with local chain, fixtures, and contract seeding
@@ -22,8 +25,6 @@ export type BaseEnvironmentConfig = {
   extensionName: string;
   /** Default password for wallet unlock operations */
   defaultPassword?: string;
-  /** Prefix for MCP tool names (e.g., "mm" -> "mm_build", "mm_launch") */
-  toolPrefix?: string;
   /** Directory for storing screenshots and other artifacts */
   artifactsDir?: string;
 };
@@ -112,6 +113,8 @@ export type WorkflowContext = {
   stateSnapshot?: StateSnapshotCapability;
   mockServer?: MockServerCapability;
   config: EnvironmentConfig;
+  /** Port metadata reported back to core from the contextFactory. Used for DaemonState persistence and /status endpoint. */
+  allocatedPorts?: PortMap;
 };
 
 /**

src/capabilities/types.ts

@@ -55,6 +55,11 @@ export type ExtensionState = {
   networkName: string | null;
   chainId: number | null;
   balance: string | null;
+  activeTab?: {
+    role: string;
+    url: string;
+    title?: string;
+  };
 };
 
 export type LaunchOptions = {