LocalNest MCP

Instructions

Implementation Reference

• src/services/workspace/helpers.js:98-145 (handler)

  The core logic for summarizing a project, counting file extensions and directory structures.

  export function summarizeProject(workspace, projectPath, maxFiles) {
    const root = normalizeTarget(workspace, projectPath);
    const st = fs.statSync(root);
    if (!st.isDirectory()) {
      throw new Error('project_path is not a directory');
    }
  
    const counts = new Map();
    let totalFiles = 0;
    let totalDirs = 0;
  
    for (const { dirs, files } of walkDirectories(workspace, root)) {
      totalDirs += dirs.length;
  
      for (const filePath of files) {
        if (path.basename(filePath).startsWith('.')) continue;
        totalFiles += 1;
  
        const ext = path.extname(filePath).toLowerCase() || '<none>';
        counts.set(ext, (counts.get(ext) || 0) + 1);
  
        if (totalFiles >= maxFiles) break;
      }
  
      if (totalFiles >= maxFiles) break;
    }
  
    const topExtensions = Array.from(counts.entries())
      .sort((a, b) => b[1] - a[1])
      .slice(0, 15)
      .map(([ext, count]) => ({ ext, count }));
  
    return {
      path: root,
      directories: totalDirs,
      files_counted: totalFiles,
      top_extensions: topExtensions,
      truncated: totalFiles >= maxFiles
    };
  }
  
  export async function readFileChunk(workspace, requestedPath, startLine, endLine, maxSpan) {
    let from = startLine;
    let to = endLine;
  
    if (to < from) to = from;
    if (to - from + 1 > maxSpan) {
      to = from + maxSpan - 1;

• src/mcp/tools/retrieval.js:453-470 (registration)

  The registration and entry point for the 'localnest_summarize_project' tool, which calls the service wrapper.

  registerJsonTool(
    'localnest_summarize_project',
    {
      title: 'Summarize Project',
      description: 'Return a high-level summary of a project directory.',
      inputSchema: {
        project_path: z.string(),
        max_files: z.number().int().min(100).max(20000).default(3000)
      },
      annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false
      }
    },
    async ({ project_path, max_files }) => normalizeProjectSummaryResult(
      workspace.summarizeProject(project_path, max_files),