typescript-analyzer-mcp

TypeScript Analyzer MCP Server - Enterprise Edition

A high-performance MCP (Model Context Protocol) server for analyzing and fixing TypeScript any types in your codebase, with advanced error handling, caching, and intelligent type inference.

Features

• 🔍 Analyze TypeScript Files: Scan files for any types and get suggested replacements
• 🛠️ Fix TypeScript Files: Automatically replace any types with more specific types
• 📊 Batch Processing: Process multiple files at once
• 🧩 Component Interface Generation: Generate TypeScript interfaces for React components
• ⚙️ Server Configuration: Dynamically update server config (log level, caching, etc.)
• 🔧 Cache Management: Clear and manage analysis caches

Installation

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Start the server:

   npm run start
   

   or

   node dist/index.js
   

Using with Claude Desktop

To use this MCP server with Claude Desktop, add it to your .claude-app.json configuration file:

{
  "mcpServers": {
    "typescript-analyzer": {
      "command": "node",
      "args": ["/path/to/typescript-analyzer-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Tools

getServerInfo

Retrieves basic information about the analyzer server (name, version, description, features, configuration).

Example:

Please provide server info

configureServer

Updates server configuration (log levels, caching, etc.) at runtime.

Parameters:

• config: A partial configuration object to merge with the current config

Example:

Please update the logLevel to 'debug' for the server

analyzeTypeScriptFile

Analyzes a TypeScript file for any types.

Parameters:

• filePath: Path to the TypeScript file to analyze
• skipCache: (optional) If true, forces a fresh analysis

Example:

Please analyze the TypeScript file src/components/Button.tsx for any types

fixTypeScriptFile

Fixes any types in a single TypeScript file.

Parameters:

• filePath: Path to the TypeScript file to fix
• fixType: Default type to use for replacement (default: "unknown")
• dryRun: If true, show changes without applying them
• skipBackup: If true, do not create a backup file before modifying

Example:

Please fix the TypeScript file src/components/Button.tsx, using Record<string, unknown> as the default replacement

batchFixTypeScriptFiles

Batch fixes any types in multiple TypeScript files.

Parameters:

• directory: Directory containing TypeScript files
• pattern: Glob pattern for files to process (e.g. "**/*.ts")
• fixType: Default type to use for replacement
• dryRun: If true, show changes without applying them
• concurrency: (optional) How many files to process in parallel

Example:

Please fix all TypeScript files in the src/components directory

generateComponentInterface

Generates a proper TypeScript interface for React component props.

Parameters:

• filePath: Path to the React component file
• componentName: Name of the component to analyze
• outputPath: (optional) Path where to save the generated interface

Example:

Please generate an interface for the Button component in src/components/Button.tsx

clearCache

Clears the analysis cache to force fresh analysis on subsequent operations.

Example:

Please clear the analysis cache

Type Mapping Strategy

The server uses a set of predefined mappings for common patterns:

Pattern	Replacement
e: any	e: React.SyntheticEvent
event: any	event: React.SyntheticEvent
onChange: any	onChange: (value: unknown) => void
onClick: any	onClick: (event: React.MouseEvent<HTMLElement>) => void
ref: any	ref: React.RefObject<HTMLElement>
data: any	data: Record<string, unknown>
options: any	options: Record<string, unknown>
config: any	config: Record<string, unknown>
props: any	props: Record<string, unknown>
items: any[]	items: unknown[]
results: any[]	results: unknown[]
callback: any	callback: (...args: unknown[]) => unknown

For patterns not covered by the mappings, it defaults to using unknown.

License

MIT