NAME

Langertha::Raider::FileTools - MCP::Server factory with local filesystem tools (list/read/write/edit)

VERSION

version 0.503

DESCRIPTION

The file tools of raider: an MCP::Server with list_files(path), read_file(path), write_file(path, content) and edit_file(path, old_string, new_string), confined to one directory.

build_file_tools_server

my $server = Langertha::Raider::FileTools::build_file_tools_server(
    root => '/some/dir',  # optional confinement root
);

Returns an MCP::Server instance with the tools list_files, read_file, write_file, and edit_file registered. When root is set, all path arguments are confined to that directory. Existing paths and nearest existing parents are resolved with realpath, so symlinks cannot be used to escape the root.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha-raider/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.