Herramientas de refactorización de MCP ts-morph

descripción general

Este servidor MCP aprovecha ts-morph para proporcionar operaciones de refactorización para bases de código TypeScript y JavaScript. Funciona con extensiones de editor como Cursor para permitir el cambio de nombre de símbolos basado en AST, el cambio de nombre de archivos/carpetas y la búsqueda de referencias.

Construcción del entorno

Agregue las siguientes configuraciones a mcp.json .

{
  "mcpServers": {
    "mcp-tsmorph-refactor": {
      // 任意のサーバー名
      "command": "node",
      // TODO: ビルド後のエントリポイントへのパスを指定してください
      "args": ["/path/to/this/repo/dist/index.js"],
      "env": {}
    }
  }
}

Características proporcionadas

Este servidor MCP proporciona las siguientes funciones de refactorización: Cada función utiliza ts-morph para analizar el AST y realizar cambios manteniendo la coherencia en todo el proyecto.

Cambiar el nombre de los símbolos ( `rename_symbol_by_tsmorph` )

Qué hace : cambia el nombre globalmente de un símbolo (función, variable, clase, interfaz, etc.) en una posición específica en un archivo especificado en todo el proyecto.
Caso de uso : desea cambiar el nombre de una función o variable, pero hay muchas referencias a ella y sería difícil cambiarla manualmente.
Información requerida : ruta del proyecto tsconfig.json , ruta del archivo de destino, posición del símbolo (línea y columna), nombre del símbolo actual, nombre del nuevo símbolo

Cambiar el nombre de un archivo o carpeta ( `rename_filesystem_entry_by_tsmorph` )

Característica : cambia el nombre del archivo o carpeta especificado y actualiza automáticamente las rutas en todas las declaraciones de import / export del proyecto.
Caso de uso : cambia la estructura de sus archivos y desea modificar las rutas de importación en consecuencia.
Información requerida : ruta tsconfig.json del proyecto, la ruta anterior y la ruta nueva.
Nota : Es posible que los alias de ruta y las importaciones de índices relativos no se actualicen por completo. Es posible que se requiera verificación manual después de cualquier cambio. Si importa utilizando rutas como "." , ".." , @/* etc., es posible que no se actualicen.

Encontrar referencias ( `find_references_by_tsmorph` )

Qué hace : busca y enumera la definición de un símbolo en una ubicación particular en un archivo especificado, así como todas sus referencias en todo el proyecto.
Caso de uso : desea saber dónde se utiliza una función o variable. Desea explorar el alcance de una refactorización.
Información requerida : ruta tsconfig.json del proyecto, ruta del archivo de destino, posición del símbolo (línea, columna).

Eliminar un alias de ruta ( `remove_path_alias_by_tsmorph` )

Función : Reemplaza los alias de ruta (como @/components ) en las declaraciones de import / export en el archivo o directorio especificado con rutas relativas (como ../../components ).
Caso de uso : desea que su proyecto sea más portable o que se ajuste a estándares de codificación específicos.
Información requerida : ruta tsconfig.json del proyecto, ruta del archivo o directorio a procesar.

(Agregue cualquier otra característica)

Información para desarrolladores

Prerrequisitos

Node.js (para la versión, consulte .node-version o volta en package.json )
pnpm (consulte el campo packageManager en package.json para conocer la versión)

configuración

Clonar el repositorio e instalar las dependencias:

git clone https://github.com/sirosuzume/mcp-tsmorph-refactor.git
cd mcp-tsmorph-refactor
pnpm install

Construir

Compila código TypeScript en JavaScript.

pnpm build

Los artefactos de compilación se envían al directorio dist .

prueba

Ejecute las pruebas unitarias.

pnpm test

Pelusa y formato

Analiza y formatea estáticamente su código.

# Lintチェック
pnpm lint

# Lint修正
pnpm lint:fix

# フォーマット
pnpm format

licencia

Este proyecto se publica bajo la licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.

MCP ts-morph Refactoring Tools

Integrations