vola-trebla avatar

Tsconfig Inheritance Flattener Mcp

vola-trebla/tsconfig-inheritance-flattener-mcp

Exposes three TypeScript config analysis tools through the compiler API. get_effective_compiler_options flattens the entire extends chain (monorepo bases, node_modules presets like @tsconfig/strictest) and returns the merged compiler options that actually apply, so your agent knows that strict mode is on or that target is ES2022 even when those are inherited. resolve_module_alias maps path aliases like @/hooks/useAuth to their physical locations on disk using the resolved baseUrl and paths. analyze_project_references validates that all referenced packages in a monorepo have composite enabled. Solves the problem where an AI reads a minimal tsconfig.json and has no idea what rules are actually enforced or where imports resolve to. Install with npx and point it at your tsconfig files.

tools
3
transport
STDIO
last updated
May 20, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

get_effective_compiler_optionsResolves the full extends chain and returns the merged compiler options that actually apply to a given tsconfig.json.

Resolves the full extends chain and returns the merged compiler options that actually apply to a given tsconfig.json.

No parameter schema in public metadata yet.

resolve_module_aliasMaps a TypeScript path alias (e.g. @/hooks/useAuth) to its physical file location on disk, using the resolved paths and baseUrl from the tsconfig.

Maps a TypeScript path alias (e.g. @/hooks/useAuth) to its physical file location on disk, using the resolved paths and baseUrl from the tsconfig.

No parameter schema in public metadata yet.

analyze_project_referencesInspects the references array in a root tsconfig.json and validates that each referenced package has composite: true.

Inspects the references array in a root tsconfig.json and validates that each referenced package has composite: true.

No parameter schema in public metadata yet.

Sponsors

Readme

🔍 tsconfig-inheritance-flattener-mcp

npm CI License: MIT

Your AI agent reads tsconfig.json. It has no idea what it actually means.

MCP server that resolves the full TypeScript config inheritance chain and returns the effective compiler options that actually apply — including everything inherited from extended base configs, monorepo packages, and node_modules presets.


🤔 The problem

Your agent reads tsconfig.json and sees:

{ "extends": "@tsconfig/strictest", "compilerOptions": { "paths": { "@/*": ["./src/*"] } } }

It has no idea that @tsconfig/strictest sets strict: true, noUncheckedIndexedAccess: true, exactOptionalPropertyTypes: true. It doesn't know that baseUrl is defined two levels up in your monorepo base config. So it:


View the full README on GitHub

Details

Repository
github.com/vola-trebla/tsconfig-inheritance-flattener-mcp
Package
tsconfig-inheritance-flattener-mcp
Transport
STDIO
Registry
MCP registry, active

More from vola-trebla