Module utils 

Utility functions for file handling, path security, and encoding

Provides common utilities needed by MCP servers: file collection with gitignore support, path security validation, byte offset conversion, and base64 encoding for pagination cursors.

Structs

PaginatedResult

Result of a paginated list operation

Constants

DEFAULT_PAGE_SIZE

Default page size for list operations

Functions

base64_decode

Base64 decode string

base64_encode

Base64 encode bytes

byte_to_line_col

Convert byte offset to line and column numbers

collect_files

Collect files recursively from a path, respecting .gitignore

decode_cursor

Decode a pagination cursor

encode_cursor

Encode a pagination cursor

is_safe_path

Check if a path is within a base directory (security boundary)

paginate

Paginate a list of items