TypeScript Analyzer MCP Server - Enterprise Edition

TypeScript 分析器 MCP 服务 - 企业版

一款高性能 MCP（Model Context Protocol）服务，用于分析和修复代码库中的 TypeScript any 类型，并提供高级错误处理、缓存和智能类型推断功能。

功能

• 🔍 分析 TypeScript 文件：扫描文件中的 any 类型并获取建议的替代类型
• 🛠️ 修复 TypeScript 文件：自动将 any 类型替换为更具体的类型
• 📊 批量处理：一次处理多个文件
• 🧩 组件接口生成：为 React 组件生成 TypeScript 接口
• ⚙️ 服务配置：动态更新服务配置（日志级别、缓存等）
• 🔧 缓存管理：清除和管理分析缓存

安装

1. 克隆此代码库
2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

4. 启动服务：

   npm run start
   

   或

   node dist/index.js
   

与 Claude Desktop 配合使用

要在 Claude Desktop 中使用此 MCP 服务，请将其添加到 .claude-app.json 配置文件中：

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

工具

getServerInfo

获取分析器服务的基本信息（名称、版本、描述、功能和配置）。

示例：

Please provide server info

configureServer

在运行时更新服务配置（日志级别、缓存等）。

参数：

• config：与当前配置合并的部分配置对象

示例：

Please update the logLevel to 'debug' for the server

analyzeTypeScriptFile

分析 TypeScript 文件中的 any 类型。

参数：

• filePath：要分析的 TypeScript 文件路径
• skipCache：（可选）若为 true，则强制执行全新分析

示例：

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

fixTypeScriptFile

修复单个 TypeScript 文件中的 any 类型。

参数：

• filePath：要修复的 TypeScript 文件路径
• fixType：用于替换的默认类型（默认值："unknown"）
• dryRun：若为 true，则显示更改但不应用
• skipBackup：若为 true，则修改前不创建备份文件

示例：

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

batchFixTypeScriptFiles

批量修复多个 TypeScript 文件中的 any 类型。

参数：

• directory：包含 TypeScript 文件的目录
• pattern：要处理文件的 Glob 模式（例如 "**/*.ts"）
• fixType：用于替换的默认类型
• dryRun：若为 true，则显示更改但不应用
• concurrency：（可选）并行处理的文件数量

示例：

Please fix all TypeScript files in the src/components directory

generateComponentInterface

为 React 组件的 props 生成合适的 TypeScript 接口。

参数：

• filePath：React 组件文件的路径
• componentName：要分析的组件名称
• outputPath：（可选）保存生成接口的路径

示例：

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

clearCache

清除分析缓存，以便后续操作重新执行分析。

示例：

Please clear the analysis cache

类型映射策略

该服务使用一组针对常见模式的预定义映射：

模式	替换类型
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

对于映射未涵盖的模式，默认使用 unknown。

许可证

MIT