The Nuanced MCP Server integrates with MCP-compatible clients to provide powerful call graph analysis tools for your TypeScript projects.

Features

The server provides two main tools for analyzing your codebase:

init tool

Initializes a new call graph for the project. After making changes, before asking for enrich output, be sure to re-run init. Parameters:
  • projectPath (string): Path where project should be initialized (defaults to current directory)

enrich tool

Returns a subgraph of the call graph for a given function. Parameters:
  • functionName (string): Name of the function to enrich
  • filePath (string, optional): Path to the file containing the function, the tool will search for the function if not provided

Prerequisites

Before installing the Nuanced MCP Server, you’ll need:
  • A valid Nuanced license key and associated email address
  • Node.js and npm installed on your system

Installation

1. Configure npm authentication

First, set up authentication for the Nuanced npm registry:
npm config set @nuanced-dev:registry 'https://nuanced-dev.nodejs.pub'
npm config set '//nuanced-dev.nodejs.pub/:_authToken' '[your-license-key]'
Replace [your-license-key] with your actual Nuanced license key.

2. Install the MCP server

Install the MCP server globally:
npm install -g @nuanced-dev/nuanced-mcp-ts@latest

3. Configure your client

Choose your preferred client to complete the setup:

4. Project configuration

Code data is stored in local .nuanced directories that you can safely check into version control or feel free to add .nuanced to your .gitignore file.