Tsconfig MCP Server

MCP server that resolves TypeScript config inheritance chains and answers what compiler options actually apply to any file

Local serverstdioTypeScript

What is the Tsconfig MCP server?

Connect Tsconfig to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP server that resolves TypeScript config inheritance chains and answers what compiler options actually apply to any file. The tsconfig mcp server is what makes that connection.

What the server does

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.

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • get_effective_compiler_options — Resolves the full extends chain and returns the merged compiler options that actually apply to a given tsconfig.json. Shows the inheritance chain
  • resolve_module_alias — 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
  • analyze_project_references — Inspects the references array in a root tsconfig.json and validates that each referenced package has composite: true. Catches broken cross-package

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Tsconfig's toolset — get_effective_compiler_options, resolve_module_alias, analyze_project_references — is a fair guide to whether it matches your workflow. It is maintained by vola-trebla; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
get_effective_compiler_optionsResolves the full extends chain and returns the merged compiler options that actually apply to a given tsconfig.json. Shows the inheritance chain, all merged options (with enums as readable strings, not magic numbers), a
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. Returns all existing candidates with extension probing.
analyze_project_referencesInspects the references array in a root tsconfig.json and validates that each referenced package has composite: true. Catches broken cross-package dependencies in TypeScript monorepos before they cause silent build failu

How to install the Tsconfig MCP server

{
  "mcpServers": {
    "tsconfig-flattener": {
      "command": "npx",
      "args": ["-y", "tsconfig-inheritance-flattener-mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Tsconfig to get effective compiler options.
  • Use Tsconfig to resolve module alias.
  • Use Tsconfig to analyze project references.

Frequently asked questions

It connects Tsconfig to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (get_effective_compiler_options, resolve_module_alias, analyze_project_references) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Tsconfig directly.