Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_DIR | No | Specifies the directory where log files (combined.log, error.log) will be stored. | ./logs |
| LOG_LEVEL | No | Controls the verbosity of logs. Options: error, warn, info, http, verbose, debug, silly. | info |
| FS_BASE_DIRECTORY | No | If set to an absolute path, all file operations performed by the server will be strictly confined within this directory and its subdirectories. This prevents the AI agent from accessing files outside the intended scope. |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| read_file | Reads the entire content of a specified file as UTF-8 text. Accepts relative or absolute paths. Relative paths are resolved against the session default set by |
| set_filesystem_default | Sets a default absolute path for the current session. Relative paths used in other filesystem tools (like readFile) will be resolved against this default. The default is cleared on server restart. |
| write_file | Writes content to a specified file. Creates the file (and necessary directories) if it doesn't exist, or overwrites it if it does. Accepts relative or absolute paths (resolved like readFile). |
| update_file | Performs targeted search-and-replace operations within an existing file using an array of {search, replace} blocks. Preferred for smaller, localized changes. For large-scale updates or overwrites, consider using |
| list_files | Lists files and directories within the specified directory. Optionally lists recursively and returns a tree-like structure. Includes an optional |
| delete_file | Removes a specific file. Accepts relative or absolute paths. |
| delete_directory | Removes a directory. Optionally removes recursively. Accepts relative or absolute paths. |
| create_directory | Creates a directory. Optionally creates parent directories. Accepts relative or absolute paths. |
| move_path | Moves or renames a file or directory. Accepts relative or absolute paths for source and destination. |
| copy_path | Copies a file or directory to a new location. Accepts relative or absolute paths. Defaults to recursive copy for directories. |