Configuration

ngmcp is configured entirely through environment variables. No configuration file is required.

Environment variables

NGMCP_GUIDE_DIRS

A colon-separated list of directories that the server is allowed to read .ng files from.

NGMCP_GUIDE_DIRS=/home/user/guides:/mnt/archive/ng

When this variable is not set, no directories are configured and the list_guide_files tool will return an empty list. Tools that accept a path argument will still work if NGMCP_ALLOW_ABSOLUTE_PATHS is enabled.

NGMCP_ALLOW_ABSOLUTE_PATHS

When set to true, 1, or yes, tools may open .ng files by absolute path even if the file is not inside one of the configured guide directories.

NGMCP_ALLOW_ABSOLUTE_PATHS=true

This is disabled by default for safety. Enabling it allows an AI agent to read any .ng file on the filesystem that the server process can access.

Summary