Ngmcp
FreeNot checkedEnables AI agents to query and browse Norton Guide database files, providing tools for reading entries, searching, and navigating menus.
About
Enables AI agents to query and browse Norton Guide database files, providing tools for reading entries, searching, and navigating menus.
README
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
NGMCP requires Python 3.12 or later.
Using uv (recommended)
The fastest and most modern way to install NGMCP is with uv:
uv tool install ngmcp
If you don't have uv installed you can use uvx.sh to
perform the installation. For GNU/Linux or macOS or similar:
curl -LsSf uvx.sh/ngmcp/install.sh | sh
or on Windows:
powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/ngmcp/install.ps1 | iex"
Using pipx
pipx install ngmcp
Configuration
How you configure your agent to use the server will depend on the agent you're using. Generally the configuration to use will be:
{
"mcpServers": {
"ngmcp": {
"command": "ngmcp",
"args": [],
"env": {
"NGMCP_GUIDE_DIRS": "/path/to/your/ng/files"
}
}
}
}
[!note] Adjust the
commandandargsdepending on your installation method.
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 |
read_entry_source |
Full plain-text Norton Guide source content of the entry at a given offset |
follow_link |
Follow a short-entry link to the target long entry |
line_search_guide |
Line-oriented full-text search through all entries |
body_search_guide |
Full-body-oriented 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
Install Ngmcp in Claude Desktop, Claude Code & Cursor
unyly install ngmcpInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add ngmcp -- uvx ngmcpFAQ
Is Ngmcp MCP free?
Yes, Ngmcp MCP is free — one-click install via Unyly at no cost.
Does Ngmcp need an API key?
No, Ngmcp runs without API keys or environment variables.
Is Ngmcp hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Ngmcp in Claude Desktop, Claude Code or Cursor?
Open Ngmcp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
wenb1n-dev/SmartDB_MCP
A universal database MCP server supporting simultaneous connections to multiple databases. It provides tools for database operations, health analysis, SQL optim
by wenb1n-devPostgres Server
This server enables interaction with PostgreSQL databases through the Model Context Protocol, optimized for the AWS Bedrock AgentCore Runtime. It provides tools
by madhurprashPostgres
Query your database in natural language
by AnthropicPostgreSQL
Read-only database access with schema inspection.
by modelcontextprotocolCompare Ngmcp with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All data MCPs