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 許可證。