Typescript Analyzer MCP

🚀 TypeScript 分析器 MCP 服务器 - 企业版

这是一款高性能的 MCP（模型上下文协议）服务器，主要用于分析和修复代码库中的 TypeScript any 类型。它具备高级错误处理、缓存和智能类型推断功能，能有效提升代码质量和开发效率。

✨ 主要特性

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

📦 安装指南

1. 克隆此仓库。
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 启动服务器：

   npm run start
   

   或

   node dist/index.js
   

🚀 快速开始

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

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

📚 详细文档

工具

getServerInfo

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

请提供服务器信息

configureServer

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

• config：要与当前配置合并的部分配置对象。 示例：

请将日志级别更新为 'debug'

analyzeTypeScriptFile

分析一个 TypeScript 文件中的 any 类型。 参数：

• filePath：要分析的 TypeScript 文件路径。
• skipCache：（可选）如果为真，则强制进行新鲜分析。 示例：

请分析 src/components/Button.tsx 文件中的 any 类型

fixTypeScriptFile

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

• filePath：要修复的 TypeScript 文件路径。
• fixType：默认替换类型（默认值："unknown"）。
• dryRun：如果为真，则显示更改而不应用。
• skipBackup：如果为真，则在修改前不创建备份文件。 示例：

请修复 src/components/Button.tsx 文件中的 any 类型，使用 Record<string, unknown> 作为默认替换

batchFixTypeScriptFiles

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

• directory：要处理的文件或目录路径。
• fixType：（可选）默认值："unknown"。
• dryRun：（可选）默认值：false。
• skipBackup：（可选）默认值：false。 示例：

请批量修复 src/components 目录下的所有 TypeScript 文件中的 any 类型

generateTypeScriptInterface

为 React 组件生成 TypeScript 接口。 参数：

• componentPath：React 组件的文件路径。
• outputPath：输出接口文件的路径（默认值：与组件文件同名的 .types.ts 文件）。 示例：

请为 components/Button.tsx 生成 TypeScript 接口

类型映射

对于未覆盖的模式，默认使用 unknown。

📄 许可证

本项目采用 MIT 许可证。