Local Dev Bridge MCP

Instructions

Implementation Reference

• index.js:264-281 (handler)

  The handler function that implements the list_directory tool logic: resolves path, reads directory entries, formats with icons, and returns formatted text content.

  async listDirectory(dirPath) {
    const resolvedPath = this.resolvePath(dirPath);
    const entries = await fs.readdir(resolvedPath, { withFileTypes: true });
    
    const items = entries.map((entry) => {
      const icon = entry.isDirectory() ? '📁' : '📄';
      return `${icon} ${entry.name}`;
    });
    
    return {
      content: [
        {
          type: 'text',
          text: `Contents of ${resolvedPath}:\n\n${items.join('\n')}`,
        },
      ],
    };
  }

• index.js:104-113 (schema)

  Input schema for the list_directory tool defining the 'path' parameter.

  inputSchema: {
    type: 'object',
    properties: {
      path: {
        type: 'string',
        description: 'Path to directory (relative to projects directory or absolute)',
      },
    },
    required: ['path'],
  },

• index.js:101-114 (registration)

  Registration of the list_directory tool metadata (name, description, schema) in the ListToolsRequestSchema response.

  {
    name: 'list_directory',
    description: 'List files and directories in a given path',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: 'Path to directory (relative to projects directory or absolute)',
        },
      },
      required: ['path'],
    },
  },

• index.js:172-173 (registration)

  Dispatch/registration of the list_directory handler in the CallToolRequestSchema switch statement.

  case 'list_directory':
    return await this.listDirectory(args.path);