ngmcp 0.1.0

MCP server for Norton Guide database files

ngmcp

ngmcp is an MCP server that exposes Norton Guide database files to AI agents. It is built on top of the ngdb library and uses fastmcp as its MCP framework.

Norton Guides are a classic hypertext help-file format from the DOS era, used widely for Clipper and similar tool documentation.

Installation

Via uvx (recommended)

uvx ngmcp

Via uv add

uv add ngmcp

Running with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ngmcp": {
      "command": "uvx",
      "args": ["ngmcp"],
      "env": {
        "NGMCP_GUIDE_DIRS": "/path/to/your/ng/files"
      }
    }
  }
}

Configuration

Environment variable	Default	Description
NGMCP_GUIDE_DIRS	(none)	Colon-separated list of directories to search for .ng files
NGMCP_ALLOW_ABSOLUTE_PATHS	false	Allow tools to open .ng files by absolute path

Available Tools

Tool	Description
get_guide_info	Title, credits, magic, made_with, menu count, and file size
list_menus	Menu structure: title and prompt list for each menu
list_entries	All entries with type, offset, line count, and first line of text
read_entry	Full plain-text content of the entry at a given offset
follow_link	Follow a short-entry link to the target long entry
search_guide	Full-text search through all entries
list_guide_files	.ng files in the configured guide directories

Hacking

See Contributing.md.

git clone https://github.com/davep/ngmcp
cd ngmcp
make setup
make checkall