LocalNest MCP

Instructions

Implementation Reference

• src/mcp/tools/core.js:43-54 (handler)

  The handler for the 'localnest_health' tool, which aggregates server status and background health reports.

  async () => {
    const status = await buildServerStatus();
    return {
      name: status.name,
      version: status.version,
      mode: status.mode,
      health: status.health,
      roots_count: Array.isArray(status.roots) ? status.roots.length : 0,
      update_recommendation: status.updates?.recommendation || 'up_to_date',
      background_health: getLastHealthReport?.() ?? null
    };
  }

• src/mcp/tools/core.js:30-55 (registration)

  Registration of the 'localnest_health' tool within the registerCoreTools function.

  registerJsonTool(
    'localnest_health',
    {
      title: 'Health',
      description: 'Return a compact runtime health summary for fast smoke checks.',
      inputSchema: {},
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false
      }
    },
    async () => {
      const status = await buildServerStatus();
      return {
        name: status.name,
        version: status.version,
        mode: status.mode,
        health: status.health,
        roots_count: Array.isArray(status.roots) ? status.roots.length : 0,
        update_recommendation: status.updates?.recommendation || 'up_to_date',
        background_health: getLastHealthReport?.() ?? null
      };
    }
  );