项目简介 MCP TypeScript重构服务器是一个为AI助手（或其他MCP客户端）提供TypeScript/JavaScript代码重构能力的后端服务。它通过Model Context Protocol (MCP) 标准，将TypeScript编译器的强大功能（如重命名符号、提取函数/常量、整理导入等）暴露为可调用的工具。这使得AI能够执行手动操作可能出错或耗时的大规模、类型安全的重构。
主要功能点
- 类型感知重构: 借助TypeScript编译器实现高度准确且类型安全的重构操作。
- 跨文件支持: 自动更新整个代码库中的导入、导出和引用，确保代码一致性。
- 安全预览模式: 所有具有破坏性的操作都支持预览，用户可在实际修改前查看所有变更。
- 详细报告: 提供文件路径和行号等详细信息，精确展示每次重构所做的修改。
- 四大工具组:
  - 文件操作 (file_operations): 用于重命名/移动文件，并自动更新所有相关导入路径。
  - 代码质量 (code_quality): 执行批量修复TypeScript错误、整理导入、移除未使用的代码。
  - 重构 (refactoring): 支持重命名符号、提取函数、提取常量和变量、推断函数返回类型等。
  - 工作区 (workspace): 查找代码引用、执行模块级重构、清理整个代码库，并提供重启TypeScript服务器的功能。

安装步骤

确保Node.js环境: 您的系统需要安装Node.js v18.x 或更高版本。

通过npm安装 (推荐):

npm install -g mcp-refactor-typescript

这会将'mcp-refactor-typescript'命令全局安装到您的系统。

从源代码安装:

git clone https://github.com/Stefan-Nitu/mcp-refactor-typescript.git
cd mcp-refactor-typescript
npm install
npm run build

构建完成后，您可以在项目目录下运行服务器。

服务器配置 (MCP客户端使用) 该MCP服务器通过标准输入/输出 (stdio) 与MCP客户端通信。MCP客户端需要配置服务器的启动命令。以下是适用于支持MCP的客户端（如Claude Desktop）的配置示例，您只需要根据您的安装方式选择其中一个添加到客户端的配置中：

如果通过npm全局安装:

// 请将以下JSON片段添加到您的MCP客户端配置文件的 "mcpServers" 部分
"mcp-refactor-typescript": {
  "command": "mcp-refactor-typescript",
  "args": []
}

'command': 指定 MCP 服务器的可执行命令，这里是全局安装后的 'mcp-refactor-typescript'。 'args': 命令的附加参数，这里没有特殊参数。

如果通过npx按需运行 (无需全局安装):

// 请将以下JSON片段添加到您的MCP客户端配置文件的 "mcpServers" 部分
"mcp-refactor-typescript": {
  "command": "npx",
  "args": ["-y", "mcp-refactor-typescript"]
}

'command': 指定 'npx' 命令。 'args': 'npx' 的参数，'-y' 表示自动确认安装，'mcp-refactor-typescript' 是要运行的包名。

基本使用方法 配置好MCP客户端后，AI助手将能够通过MCP协议调用此服务器提供的重构工具。例如，当您在AI助手中向LLM提出“重命名文件'old-name.ts'为'new-name.ts'”的请求时，LLM可能会生成一个类似以下的JSON-RPC请求，并通过MCP客户端发送给此服务器：

// 这是一个AI助手可能发送给MCP服务器的请求示例 (JSON-RPC)
{
  "jsonrpc": "2.0",
  "method": "tool_code",
  "params": {
    "tool": "file_operations",
    "params": {
      "operation": "rename_file",
      "sourcePath": "src/old-name.ts",
      "name": "new-name.ts",
      "preview": false
    }
  },
  "id": "some-unique-id"
}

服务器会执行重构操作，并将结果以JSON格式返回给LLM客户端。您也可以使用'MCP Inspector'等工具直接与服务器交互进行测试和调试。

关键词

信息