LocalNest MCP

Instructions

Implementation Reference

• src/services/update/service.js:250-316 (handler)

  The selfUpdate method within UpdateService handles the actual npm update and skill synchronization logic, including a dry-run mode and an explicit user approval requirement.

    async selfUpdate({ approvedByUser = false, dryRun = false, version = 'latest', reinstallSkill = true } = {}) {
      if (!approvedByUser) {
        return {
          ok: false,
          skipped: true,
          reason: 'approval_required',
          message: 'User approval is required. Ask: "LocalNest has a newer version. Update now?"'
        };
      }
  
      const installStep = buildInstallCommand(this.packageName, version);
      const skillStep = buildSkillSyncCommand();
      const planned = [
        [installStep.command, ...installStep.args].join(' '),
        reinstallSkill ? [skillStep.command, ...skillStep.args].join(' ') : null
      ].filter(Boolean);
  
      if (dryRun) {
        const validation = this.buildDryRunValidation({ reinstallSkill, version });
        return {
          ok: validation.ok,
          skipped: true,
          dry_run: true,
          validation,
          planned_commands: planned,
          restart_required: true
        };
      }
  
      const installResult = this.runCommand(installStep.command, installStep.args);
      if (!installResult.ok) {
        return {
          ok: false,
          step: 'npm_install',
          restart_required: false,
          planned_commands: planned,
          install: installResult
        };
      }
  
      let skillResult = null;
      if (reinstallSkill) {
        skillResult = this.runCommand(skillStep.command, skillStep.args);
        if (!skillResult.ok) {
          return {
            ok: false,
            step: 'skill_sync',
            restart_required: false,
            planned_commands: planned,
            install: installResult,
            skill_sync: skillResult
          };
        }
      }
  
      const status = await this.getStatus({ force: true, channel: normalizeUpdateChannel(version) || 'stable' });
      return {
        ok: true,
        step: 'completed',
        restart_required: true,
        planned_commands: planned,
        install: installResult,
        skill_sync: skillResult,
        update_status: status
      };
    }
  }

• src/mcp/tools/core.js:92-118 (registration)

  Registration of the 'localnest_update_self' tool in the core tools registry, which calls the updates.selfUpdate service method.

  registerJsonTool(
    ['localnest_update_self'],
    {
      title: 'Update Self',
      description: 'Update localnest-mcp globally via npm and sync bundled skill. Supports stable, beta, or explicit version targets. Requires explicit user approval.',
      inputSchema: {
        approved_by_user: z.boolean().default(false),
        dry_run: z.boolean().default(false),
        version: z.string().default('latest'),
        reinstall_skill: z.boolean().default(true)
      },
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: false,
        openWorldHint: true
      }
    },
    async ({ approved_by_user, dry_run, version, reinstall_skill }) => normalizeUpdateSelfResult(
      await updates.selfUpdate({
        approvedByUser: approved_by_user,
        dryRun: dry_run,
        version,
        reinstallSkill: reinstall_skill
      })
    )
  );