TypeScript Analyzer MCP Server - Enterprise Edition

TypeScript Analyzer MCP Server - Enterprise Edition

コードベース内の TypeScript の any 型を分析して修正する、高パフォーマンスの MCP（Model Context Protocol）サーバーです。高度なエラー処理、キャッシュ、インテリジェントな型推論を備えています。

機能

• 🔍 TypeScript ファイルの分析：ファイルをスキャンして any 型を検出し、推奨される置き換え型を取得します
• 🛠️ TypeScript ファイルの修正：any 型をより具体的な型に自動で置き換えます
• 📊 バッチ処理：複数のファイルを一度に処理します
• 🧩 コンポーネントインターフェースの生成：React コンポーネント用の TypeScript インターフェースを生成します
• ⚙️ サーバー設定：サーバー設定（ログレベル、キャッシュなど）を動的に更新します
• 🔧 キャッシュ管理：分析キャッシュをクリアして管理します

インストール

1. このリポジトリをクローンする
2. 依存関係をインストールする：

   npm install
   

3. プロジェクトをビルドする：

   npm run build
   

4. サーバーを起動する：

   npm run start
   

   または

   node dist/index.js
   

Claude Desktop での使用

この MCP サーバーを Claude Desktop で使用するには、.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