frontmcp 1.2.1 → 1.4.0

package/README.md

@@ -7,10 +7,10 @@
 </picture>
 <hr>
 
-**The TypeScript way to build MCP servers with decorators, DI, and Streamable HTTP.**
+**The production-grade, TypeScript-first framework for building MCP servers — decorators, DI, auth, and Streamable HTTP, batteries included.**
 
 [![NPM - @frontmcp/sdk](https://img.shields.io/npm/v/@frontmcp/sdk.svg?v=2)](https://www.npmjs.com/package/@frontmcp/sdk)
-[![Node](https://img.shields.io/badge/node-%3E%3D22-339933?logo=node.js&logoColor=white)](https://nodejs.org)
+[![Node](https://img.shields.io/badge/node-%3E%3D24-339933?logo=node.js&logoColor=white)](https://nodejs.org)
 [![License](https://img.shields.io/github/license/agentfront/frontmcp.svg?v=1)](https://github.com/agentfront/frontmcp/blob/main/LICENSE)
 [![Snyk](https://snyk.io/test/github/agentfront/frontmcp/badge.svg)](https://snyk.io/test/github/agentfront/frontmcp)
 
@@ -20,12 +20,17 @@
 
 ---
 
-FrontMCP is a **TypeScript-first framework** for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io).
-You write clean, typed code; FrontMCP handles the protocol, transport, DI, session/auth, and execution flow.
+FrontMCP turns the [Model Context Protocol](https://modelcontextprotocol.io) into a
+typed, declarative framework. You write clean `@Tool`, `@Resource`, and `@App`
+classes; FrontMCP handles the protocol, transport, dependency injection, sessions,
+auth, and execution flow — and the **same server runs locally and ships to
+production unchanged**.
 
 ```ts
 import 'reflect-metadata';
+
 import { FrontMcp, LogLevel } from '@frontmcp/sdk';
+
 import HelloApp from './hello.app';
 
 @FrontMcp({
@@ -37,6 +42,14 @@ import HelloApp from './hello.app';
 export default class Server {}
 ```
 
+## Why FrontMCP
+
+- **Typed by default** — decorators + Zod schemas give end-to-end types from input to output, with editor autocomplete and compile-time checks.
+- **Batteries included** — auth (OAuth/JWKS/DCR), sessions, transport, discovery, and DI are built in, not bolted on.
+- **Ship anywhere** — one codebase deploys to Node, Vercel, AWS Lambda, Cloudflare Workers, or a serverless bundle.
+- **Production-minded** — stateful/stateless sessions, high-availability transport, structured observability, and a 95%+ tested core.
+- **Extensible** — plugins, lifecycle hooks, OpenAPI adapters, and external MCP sub-apps when you outgrow the defaults.
+
 ## Installation
 
 **Node.js 24+** required.
@@ -50,34 +63,30 @@ npm i -D frontmcp @types/node@^24
 npx frontmcp init
 ```
 
-> Full setup guide: [Installation][docs-install]
+> Full setup guide: [Installation][docs-install] &middot; [Quickstart][docs-quickstart]
 
 ## Capabilities
 
-| Capability           | Description                                                                     | Docs                            |
-| -------------------- | ------------------------------------------------------------------------------- | ------------------------------- |
-| **@FrontMcp Server** | Decorator-configured server with info, apps, HTTP, logging, session, auth       | [Server][docs-server]           |
-| **@App**             | Organizational units grouping tools, resources, prompts with optional isolation | [Apps][docs-apps]               |
-| **@Tool**            | Typed actions with Zod schemas — class or function style                        | [Tools][docs-tools]             |
-| **@Resource**        | Read-only data exposure with static and template URIs                           | [Resources][docs-resources]     |
-| **@Prompt**          | Reusable message templates returning `GetPromptResult`                          | [Prompts][docs-prompts]         |
-| **@Agent**           | Orchestrated multi-step tool chains                                             | [Agents][docs-agents]           |
-| **Elicitation**      | Request structured user input mid-flow                                          | [Elicitation][docs-elicitation] |
-| **Skills**           | HTTP-discoverable tool manifests for agent marketplaces                         | [Skills][docs-skills]           |
-| **Discovery**        | Automatic capability advertisement for MCP clients                              | [Discovery][docs-discovery]     |
-| **Authentication**   | Remote OAuth, Local OAuth, JWKS, DCR, per-app auth                              | [Authentication][docs-auth]     |
-| **Sessions**         | Stateful/stateless session modes with JWT or UUID transport IDs                 | [Server][docs-server]           |
-| **Direct Client**    | In-process `create()`, `connect()`, `connectOpenAI()`, `connectClaude()`        | [Direct Client][docs-direct]    |
-| **Transport**        | Streamable HTTP + SSE with session headers                                      | [Transport][docs-transport]     |
-| **Ext-Apps**         | Mount external MCP servers as sub-apps                                          | [Ext-Apps][docs-ext-apps]       |
-| **Hooks**            | 5 hook families: tool, list-tools, HTTP, resource, prompt                       | [Hooks][docs-hooks]             |
-| **Providers / DI**   | Scoped dependency injection with GLOBAL and CONTEXT scopes                      | [Providers][docs-providers]     |
-| **Plugins**          | Cache, Remember, CodeCall, Dashboard — or build your own                        | [Plugins][docs-plugins]         |
-| **Adapters**         | Generate tools from OpenAPI specs                                               | [Adapters][docs-adapters]       |
-| **Testing**          | E2E fixtures, matchers, HTTP mocking for MCP servers                            | [Testing][docs-testing]         |
-| **UI Library**       | HTML/React widgets, SSR, MCP Bridge, web components                             | [UI][docs-ui]                   |
-| **CLI**              | `create`, `init`, `dev`, `build`, `inspector`, `doctor`                         | [CLI][docs-install]             |
-| **Deployment**       | Local dev, production builds, version alignment                                 | [Deployment][docs-deploy]       |
+**Build** — decorator-configured [`@FrontMcp` server][docs-server] and [`@App`][docs-apps]
+domains; typed [`@Tool`][docs-tools], [`@Resource`][docs-resources], and
+[`@Prompt`][docs-prompts] primitives; [`@Agent`][docs-agents] multi-step chains; and
+scoped [Providers / DI][docs-providers].
+
+**Secure** — [Remote & Local OAuth, JWKS, DCR, per-app auth][docs-auth] with
+stateful / stateless [sessions][docs-server] (JWT or UUID transport IDs).
+
+**Connect & operate** — [Streamable HTTP + SSE transport][docs-transport],
+capability [discovery][docs-discovery], [elicitation][docs-elicitation],
+[hooks][docs-hooks], HTTP-discoverable [skills][docs-skills],
+[external MCP sub-apps][docs-ext-apps], an in-process [Direct Client][docs-direct]
+(`connectOpenAI` / `connectClaude`), and first-class [deployment][docs-deploy].
+
+**Extend & tooling** — official [plugins][docs-plugins] (Cache, Remember, CodeCall,
+Dashboard), the [OpenAPI adapter][docs-adapters], a [UI library][docs-ui] (HTML/React
+widgets, SSR, MCP Bridge), an [E2E testing framework][docs-testing], and a
+[CLI][docs-install] (`create`, `init`, `dev`, `build`, `inspect`, `doctor`).
+
+→ Full reference: **[docs.agentfront.dev/frontmcp][docs-home]**
 
 ## Packages
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -31,9 +31,9 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.10.0",
-    "@frontmcp/lazy-zod": "1.2.1",
-    "@frontmcp/utils": "1.2.1",
-    "@frontmcp/skills": "1.2.1",
+    "@frontmcp/lazy-zod": "1.4.0",
+    "@frontmcp/utils": "1.4.0",
+    "@frontmcp/skills": "1.4.0",
     "commander": "^13.0.0",
     "tslib": "^2.3.0",
     "vectoriadb": "^2.2.0",

package/src/commands/build/exec/bin-meta.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Issue #411 — write `bin-meta.json` next to the CLI bundle. The per-bin
+ * `<bin> install -p claude|codex` reads this sidecar at runtime to drive
+ * the shared plugin-emitter without re-running schema extraction.
+ *
+ * Shape:
+ * {
+ *   "name": "<bin>",
+ *   "version": "<bin-version>",
+ *   "description": "<from cliConfig or package.json>",
+ *   "mcpDefault": { "command": "<bin>", "args": ["serve", "--stdio"] },
+ *   "prompts": [{ "name", "description", "arguments": [...] }],
+ *   "skills": [{ "name", "description", "instructionFile" (path under _skills/), "resourceDirs": { references?, examples?, scripts?, assets? } }]
+ * }
+ */
+import type { FrontmcpExecConfig } from './config';
+import type { ExtractedSchema } from './cli-runtime/schema-extractor';
+export interface BinMeta {
+    name: string;
+    version: string;
+    description: string;
+    mcpDefault: {
+        command: string;
+        args: string[];
+    };
+    prompts: Array<{
+        name: string;
+        description?: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    }>;
+    skills: Array<{
+        name: string;
+        description?: string;
+        tags?: string[];
+        license?: string;
+        instructionFile?: string;
+        resourceDirs?: {
+            references?: string;
+            examples?: string;
+            scripts?: string;
+            assets?: string;
+        };
+    }>;
+}
+export declare function writeBinMeta(outDir: string, config: FrontmcpExecConfig, schema: ExtractedSchema): Promise<void>;

package/src/commands/build/exec/bin-meta.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Issue #411 — write `bin-meta.json` next to the CLI bundle. The per-bin
+ * `<bin> install -p claude|codex` reads this sidecar at runtime to drive
+ * the shared plugin-emitter without re-running schema extraction.
+ *
+ * Shape:
+ * {
+ *   "name": "<bin>",
+ *   "version": "<bin-version>",
+ *   "description": "<from cliConfig or package.json>",
+ *   "mcpDefault": { "command": "<bin>", "args": ["serve", "--stdio"] },
+ *   "prompts": [{ "name", "description", "arguments": [...] }],
+ *   "skills": [{ "name", "description", "instructionFile" (path under _skills/), "resourceDirs": { references?, examples?, scripts?, assets? } }]
+ * }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeBinMeta = writeBinMeta;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const utils_1 = require("@frontmcp/utils");
+async function writeBinMeta(outDir, config, schema) {
+    const meta = {
+        name: config.name,
+        version: config.version ?? '0.0.0',
+        description: config.cli?.description ?? `${config.name} (FrontMCP server)`,
+        mcpDefault: { command: config.name, args: ['serve', '--stdio'] },
+        prompts: schema.prompts.map((p) => ({
+            name: p.name,
+            description: p.description,
+            arguments: p.arguments,
+        })),
+        skills: schema.skillAssets.map((asset) => {
+            // The bin runtime expects RELATIVE paths under `_skills/` so the bundle
+            // is portable across install destinations.
+            const instructionFile = asset.instructionFile
+                ? path.join('_skills', `${asset.skillName}--${path.basename(asset.instructionFile)}`)
+                : undefined;
+            const resourceDirs = {};
+            for (const kind of ['references', 'examples', 'scripts', 'assets']) {
+                if (asset.resourceDirs?.[kind]) {
+                    resourceDirs[kind] = path.join('_skills', `${asset.skillName}--${kind}`);
+                }
+            }
+            return {
+                name: asset.skillName,
+                description: asset.description,
+                tags: asset.tags && asset.tags.length > 0 ? asset.tags : undefined,
+                license: asset.license,
+                instructionFile,
+                resourceDirs: Object.keys(resourceDirs).length > 0 ? resourceDirs : undefined,
+            };
+        }),
+    };
+    // Drop undefined fields so the JSON payload matches the TS interface (no
+    // explicit "description": undefined keys land in stringified output).
+    const cleanSkills = meta.skills.map((s) => omitUndefined(s));
+    await (0, utils_1.writeJSON)(path.join(outDir, 'bin-meta.json'), { ...meta, skills: cleanSkills });
+}
+function omitUndefined(obj) {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+//# sourceMappingURL=bin-meta.js.map

package/src/commands/build/exec/bin-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin-meta.js","sourceRoot":"","sources":["../../../../../src/commands/build/exec/bin-meta.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Issue #411 — write `bin-meta.json` next to the CLI bundle. The per-bin\n * `<bin> install -p claude|codex` reads this sidecar at runtime to drive\n * the shared plugin-emitter without re-running schema extraction.\n *\n * Shape:\n * {\n *   \"name\": \"<bin>\",\n *   \"version\": \"<bin-version>\",\n *   \"description\": \"<from cliConfig or package.json>\",\n *   \"mcpDefault\": { \"command\": \"<bin>\", \"args\": [\"serve\", \"--stdio\"] },\n *   \"prompts\": [{ \"name\", \"description\", \"arguments\": [...] }],\n *   \"skills\": [{ \"name\", \"description\", \"instructionFile\" (path under _skills/), \"resourceDirs\": { references?, examples?, scripts?, assets? } }]\n * }\n */\n\nimport * as path from 'path';\n\nimport { writeJSON } from '@frontmcp/utils';\n\nimport type { FrontmcpExecConfig } from './config';\nimport type { ExtractedSchema } from './cli-runtime/schema-extractor';\n\nexport interface BinMeta {\n  name: string;\n  version: string;\n  description: string;\n  mcpDefault: { command: string; args: string[] };\n  prompts: Array<{\n    name: string;\n    description?: string;\n    arguments?: Array<{ name: string; description?: string; required?: boolean }>;\n  }>;\n  skills: Array<{\n    name: string;\n    description?: string;\n    tags?: string[];\n    license?: string;\n    instructionFile?: string;\n    resourceDirs?: { references?: string; examples?: string; scripts?: string; assets?: string };\n  }>;\n}\n\nexport async function writeBinMeta(\n  outDir: string,\n  config: FrontmcpExecConfig,\n  schema: ExtractedSchema,\n): Promise<void> {\n  const meta: BinMeta = {\n    name: config.name,\n    version: config.version ?? '0.0.0',\n    description: config.cli?.description ?? `${config.name} (FrontMCP server)`,\n    mcpDefault: { command: config.name, args: ['serve', '--stdio'] },\n    prompts: schema.prompts.map((p) => ({\n      name: p.name,\n      description: p.description,\n      arguments: p.arguments,\n    })),\n    skills: schema.skillAssets.map((asset) => {\n      // The bin runtime expects RELATIVE paths under `_skills/` so the bundle\n      // is portable across install destinations.\n      const instructionFile = asset.instructionFile\n        ? path.join('_skills', `${asset.skillName}--${path.basename(asset.instructionFile)}`)\n        : undefined;\n      const resourceDirs: BinMeta['skills'][number]['resourceDirs'] = {};\n      for (const kind of ['references', 'examples', 'scripts', 'assets'] as const) {\n        if (asset.resourceDirs?.[kind]) {\n          resourceDirs[kind] = path.join('_skills', `${asset.skillName}--${kind}`);\n        }\n      }\n      return {\n        name: asset.skillName,\n        description: asset.description,\n        tags: asset.tags && asset.tags.length > 0 ? asset.tags : undefined,\n        license: asset.license,\n        instructionFile,\n        resourceDirs: Object.keys(resourceDirs).length > 0 ? resourceDirs : undefined,\n      };\n    }),\n  };\n\n  // Drop undefined fields so the JSON payload matches the TS interface (no\n  // explicit \"description\": undefined keys land in stringified output).\n  const cleanSkills = meta.skills.map((s) => omitUndefined(s));\n  await writeJSON(path.join(outDir, 'bin-meta.json'), { ...meta, skills: cleanSkills });\n}\n\nfunction omitUndefined<T extends Record<string, unknown>>(obj: T): Partial<T> {\n  const out: Partial<T> = {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (v !== undefined) out[k as keyof T] = v as T[keyof T];\n  }\n  return out;\n}\n"]}

package/src/commands/build/exec/cli-runtime/generate-cli-entry.js

@@ -1362,16 +1362,158 @@ function generateInstallCommand(appName, nativeDeps, selfContained) {
             depEntries.push(`  { name: ${JSON.stringify(pkg)}, type: 'npm', install: 'npm install ${pkg}', check: 'npm ls ${pkg}' }`);
         }
     }
-    return `program
+    return `function _frontmcpCollectArg(value, acc) { return Array.isArray(acc) ? acc.concat(value) : [value]; }
+
+program
   .command('install')
-  .description('Install to ~/.frontmcp/ and set up dependencies')
+  .description('Install to ~/.frontmcp/ and set up dependencies, OR emit an IDE plugin (use -p)')
   .option('--prefix <path>', 'Installation prefix directory')
   .option('--bin-dir <path>', 'Directory for symlink (default: ~/.local/bin or /usr/local/bin)')
+  .option('-p, --provider <provider>', 'Emit plugin for provider: claude | codex (repeatable)', _frontmcpCollectArg, [])
+  .option('--scope <scope>', 'Plugin scope when -p is set: project | user', 'project')
+  .option('--no-skills', 'Skip the skills/ subtree (when -p claude)')
+  .option('--no-commands', 'Skip the commands/ subtree (when -p claude)')
+  .option('--only-mcp', 'Skip plugin folder; just register the MCP server')
+  .option('--command <cmd>', 'Override MCP server invocation in the plugin manifest')
+  .option('--env <name>', 'Add env-var placeholder to plugin manifest (repeatable)', _frontmcpCollectArg, [])
+  .option('--dir <dir>', 'Override plugin destination root')
+  .option('--dry-run', 'Print plan; do not write')
+  .option('--status', 'Print install status per provider; exit 0')
   .action(async function(opts) {
     var fs = require('fs');
     var pathMod = require('path');
     var os = require('os');
     var exec = require('child_process').execSync;
+
+    // Issue #411 — when -p is set OR --status is set, run the plugin-install
+    // path instead of the legacy bundle-copy + symlink behavior.
+    var providers = Array.isArray(opts.provider) ? opts.provider : [];
+    if (opts.status || providers.length > 0) {
+      var emitter = require('./plugin-emitter');
+      var binMetaPath = pathMod.join(SCRIPT_DIR, 'bin-meta.json');
+      var meta;
+      try { meta = JSON.parse(fs.readFileSync(binMetaPath, 'utf8')); }
+      catch (e) {
+        console.error('Could not read bin-meta.json at ' + binMetaPath + '. Was the bin built with a recent frontmcp?');
+        process.exit(1);
+      }
+      var pkgJsonPath = pathMod.join(__dirname, '..', '..', 'package.json');
+      var cliVersion = '0.0.0';
+      try { cliVersion = (require(pkgJsonPath) || {}).version || '0.0.0'; } catch (e) { /* ok */ }
+
+      function resolveDestRoot() {
+        if (opts.dir) return pathMod.resolve(opts.dir);
+        if (opts.scope === 'user') return pathMod.join(os.homedir(), '.claude', 'plugins');
+        return pathMod.join(process.cwd(), '.claude', 'plugins');
+      }
+
+      if (opts.status) {
+        console.log(meta.name + ' install --status');
+        var destRootSt = resolveDestRoot();
+        var pluginDirSt = pathMod.join(destRootSt, meta.name);
+        var installed = await emitter.readInstalledPluginVersion(pluginDirSt);
+        if (installed) {
+          var tag = installed === meta.version ? 'installed' : 'outdated';
+          console.log('  claude:    ' + tag + ' v' + installed + (tag === 'outdated' ? ' (bin at v' + meta.version + ')' : '') + ' at ' + pluginDirSt);
+        } else {
+          console.log('  claude:    not installed at ' + pluginDirSt);
+        }
+        var codexConfigSt = pathMod.join(os.homedir(), '.codex', 'config.toml');
+        if (fs.existsSync(codexConfigSt) && fs.readFileSync(codexConfigSt, 'utf8').indexOf('# frontmcp:codex-start:' + meta.name) !== -1) {
+          console.log('  codex:     installed entry for ' + meta.name + ' in ' + codexConfigSt);
+        } else {
+          console.log('  codex:     not installed in ' + codexConfigSt);
+        }
+        return;
+      }
+
+      function buildSkills() {
+        if (opts.skills === false || opts.onlyMcp) return [];
+        var out = [];
+        for (var i = 0; i < (meta.skills || []).length; i++) {
+          var s = meta.skills[i];
+          var resourceDirs = {};
+          if (s.resourceDirs) {
+            for (var k in s.resourceDirs) {
+              if (Object.prototype.hasOwnProperty.call(s.resourceDirs, k)) {
+                resourceDirs[k] = pathMod.join(SCRIPT_DIR, s.resourceDirs[k]);
+              }
+            }
+          }
+          out.push({
+            name: s.name,
+            description: s.description || (s.name + ' skill from ' + meta.name),
+            tags: Array.isArray(s.tags) && s.tags.length > 0 ? s.tags : undefined,
+            license: s.license || undefined,
+            instructionFile: s.instructionFile ? pathMod.join(SCRIPT_DIR, s.instructionFile) : undefined,
+            resourceDirs: Object.keys(resourceDirs).length > 0 ? resourceDirs : undefined,
+          });
+        }
+        return out;
+      }
+
+      function buildCommands() {
+        if (opts.commands === false || opts.onlyMcp) return [];
+        return (meta.prompts || []).map(function(p) {
+          return { name: p.name, description: p.description, arguments: p.arguments };
+        });
+      }
+
+      for (var pi = 0; pi < providers.length; pi++) {
+        var provider = providers[pi];
+        if (provider === 'claude') {
+          var destRoot = resolveDestRoot();
+          var result = await emitter.emitClaudePlugin({
+            destRoot: destRoot,
+            name: meta.name,
+            version: meta.version,
+            description: meta.description,
+            mcpCommand: opts.command || meta.mcpDefault.command,
+            mcpArgs: meta.mcpDefault.args,
+            envHints: Array.isArray(opts.env) ? opts.env : [],
+            skills: buildSkills(),
+            commands: buildCommands(),
+            cliVersion: cliVersion,
+            dryRun: opts.dryRun,
+          });
+          if (opts.dryRun) {
+            console.log('[install:claude] dry-run plan');
+            console.log('  pluginDir: ' + result.pluginDir);
+            console.log('  filesWritten (planned):');
+            for (var fwi = 0; fwi < result.filesWritten.length; fwi++) console.log('    + ' + result.filesWritten[fwi]);
+          } else {
+            console.log('✓ Wrote ' + result.pluginDir + '/ (' + (result.manifest.skills || []).length + ' skills, ' + ((result.manifest.commands || []).length) + ' commands, 1 MCP server)');
+            console.log('  Restart Claude Code (or run /plugins reload) to pick up the plugin.');
+          }
+        } else if (provider === 'codex') {
+          var codexConfig = pathMod.join(os.homedir(), '.codex', 'config.toml');
+          var env = {};
+          var envList = Array.isArray(opts.env) ? opts.env : [];
+          for (var ei = 0; ei < envList.length; ei++) env[envList[ei]] = '${'$'}{' + envList[ei] + '}';
+          var codexResult = await emitter.emitCodexEntry({
+            configPath: codexConfig,
+            name: meta.name,
+            command: opts.command || meta.mcpDefault.command,
+            args: meta.mcpDefault.args,
+            env: env,
+            dryRun: opts.dryRun,
+          });
+          if (opts.dryRun) {
+            console.log('[install:codex] dry-run plan');
+            console.log('  configPath: ' + codexConfig);
+            console.log(codexResult.configContent);
+          } else {
+            console.log('✓ Updated ' + codexConfig + ' with [[mcp_servers]] entry for ' + meta.name);
+          }
+        } else {
+          console.error('Unknown provider: ' + provider);
+          process.exitCode = 1;
+          return;
+        }
+      }
+      return;
+    }
+
     var installBase = opts.prefix || FRONTMCP_HOME;
     var appDir = pathMod.join(installBase, 'apps', ${JSON.stringify(appName)});
     var dirs = ['', '/data', '/sessions', '/credentials'].map(function(s) { return appDir + s; });
@@ -1432,13 +1574,63 @@ ${depEntries.join(',\n')}
 
 program
   .command('uninstall')
-  .description('Remove from ~/.frontmcp/ and clean up')
+  .description('Remove from ~/.frontmcp/, OR remove an IDE plugin (use -p)')
   .option('--prefix <path>', 'Installation prefix directory')
   .option('--bin-dir <path>', 'Directory where symlink was created')
+  .option('-p, --provider <provider>', 'Remove plugin for provider: claude | codex (repeatable)', _frontmcpCollectArg, [])
+  .option('--scope <scope>', 'Plugin scope when -p is set: project | user', 'project')
+  .option('--dir <dir>', 'Override plugin destination root')
   .action(async function(opts) {
     var fs = require('fs');
     var pathMod = require('path');
     var os = require('os');
+
+    // Issue #411 — when -p is set, route through the shared plugin-emitter
+    // to remove the IDE plugin instead of the legacy ~/.frontmcp uninstall.
+    var providers = Array.isArray(opts.provider) ? opts.provider : [];
+    if (providers.length > 0) {
+      var emitter = require('./plugin-emitter');
+      var binMetaPath = pathMod.join(SCRIPT_DIR, 'bin-meta.json');
+      var meta;
+      try { meta = JSON.parse(fs.readFileSync(binMetaPath, 'utf8')); }
+      catch (e) {
+        console.error('Could not read bin-meta.json at ' + binMetaPath + '. Was the bin built with a recent frontmcp?');
+        process.exit(1);
+      }
+
+      function resolveDestRoot() {
+        if (opts.dir) return pathMod.resolve(opts.dir);
+        if (opts.scope === 'user') return pathMod.join(os.homedir(), '.claude', 'plugins');
+        return pathMod.join(process.cwd(), '.claude', 'plugins');
+      }
+
+      for (var pi = 0; pi < providers.length; pi++) {
+        var provider = providers[pi];
+        if (provider === 'claude') {
+          var destRoot = resolveDestRoot();
+          var result = await emitter.removeClaudePlugin({ destRoot: destRoot, name: meta.name });
+          if (result.removed.length === 0) {
+            console.log('  claude: nothing to remove at ' + result.pluginDir);
+          } else {
+            console.log('✓ Removed ' + result.removed.length + ' file(s) from ' + result.pluginDir);
+          }
+        } else if (provider === 'codex') {
+          var codexConfig = pathMod.join(os.homedir(), '.codex', 'config.toml');
+          var codexResult = await emitter.removeCodexEntry({ configPath: codexConfig, name: meta.name });
+          if (codexResult.removed) {
+            console.log('✓ Removed [[mcp_servers]] entry for ' + meta.name + ' from ' + codexConfig);
+          } else {
+            console.log('  codex: no entry for ' + meta.name + ' in ' + codexConfig);
+          }
+        } else {
+          console.error('Unknown provider: ' + provider);
+          process.exitCode = 1;
+          return;
+        }
+      }
+      return;
+    }
+
     var uninstallBase = opts.prefix || FRONTMCP_HOME;
     var appDir = pathMod.join(uninstallBase, 'apps', ${JSON.stringify(appName)});