Unrestricted Development MCP Server

Instructions

Implementation Reference

• src/tools/filesystem.ts:174-204 (handler)

  The deleteFile function implements the core logic for deleting a file using Node.js fs.unlink. It handles errors and returns a standardized ToolResponse in MCP format.

  export async function deleteFile(args: z.infer<typeof deleteFileSchema>): Promise<ToolResponse> {
    try {
      await fs.unlink(args.path);
  
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify({
              success: true,
              path: args.path,
              message: 'File deleted successfully'
            }, null, 2)
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify({
              success: false,
              error: error instanceof Error ? error.message : String(error)
            }, null, 2)
          }
        ],
        isError: true
      };
    }
  }

• src/tools/filesystem.ts:528-541 (schema)

  MCP tool schema definition for fs_delete_file, defining the input schema advertised to MCP clients.

  {
    name: 'fs_delete_file',
    description: 'Delete a file from the filesystem. This operation is irreversible.',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: 'Absolute or relative path to the file to delete'
        }
      },
      required: ['path']
    }
  },

• src/index.ts:317-319 (registration)

  Registration and dispatch logic in the main MCP CallToolRequest handler that routes calls to fs_delete_file to the deleteFile implementation.

  if (name === 'fs_delete_file') {
    const validated = deleteFileSchema.parse(args);
    return await deleteFile(validated);

• src/tools/filesystem.ts:31-33 (schema)

  Zod runtime validation schema used by the handler and dispatcher for input validation.

  export const deleteFileSchema = z.object({
    path: z.string().describe('Absolute or relative path to the file to delete')
  });