Code Refactor

io.github.zhouhengchang由 GitHub 账号 zhouhengchang 发布v1.0.4更新于 Oct 25, 2026

Refactor legacy code into modern, idiomatic code without changing its behavior.

已验证Streamable HTTP可网页运行开发者工具商业与电商AI 与机器学习

概览

AI 生成的概览

一个 MCP 服务器,通过本地 Ollama 模型或 OpenAI 兼容云端接口完成代码重构,并生成代码、测试、文档、SQL 等内容。

可以做什么
重构源代码为现代惯用写法并保持行为不变,并检查当前可用的推理后端(README 工具)。生成可运行示例代码、自动 mock 依赖的单元测试,以及 README/API 文档/变更日志。审查代码并给出分级建议,按表结构生成或优化 SQL 并拦截破坏性语句。生成多平台文案、翻译、视频脚本和简历改写。审查合同中的高/中风险条款与缺失条款。按订单号查询单次调用、列出最近订单用于对账,并查询技能上架状态与价格。
适用场景
适合让助手把遗留代码现代化、搭建测试与文档,或起草 SQL、文案、翻译和合同审查;可完全用 Ollama 本地运行,也可用云端模型获得更高质量。
运行要求
可作为远程端点,也可作为本地 npm 包运行(npx workbuddy-code-refactor-connector)。本地后端需要可访问的 Ollama 服务,通过 OLLAMA_HOST 和 OLLAMA_MODEL 配置;云端后端需设置 REFACTOR_BACKEND=openai 以及 OPENAI_BASE_URL、OPENAI_MODEL、OPENAI_API_KEY。REFACTOR_TIMEOUT_MS 默认 180000 毫秒。
安装前请注意
云端后端会把代码和提示词发送给第三方 OpenAI 兼容接口,只有本地 Ollama 后端能让代码不出本机。多个工具按次计费,使用会产生费用,订单工具会显示调用金额与状态。API 密钥从 OPENAI_API_KEY 读取,应通过环境变量提供,不要提交到仓库。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Code Refactor,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.zhouhengchang%2Fcode-refactor/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "code-refactor": {
      "type": "http",
      "url": "https://code-refactor-api.app.workbuddy.host/mcp"
    }
  }
}

README

workbuddy-code-refactor-connector

WorkBuddy 代码重构连接器 —— 一个基于 Model Context Protocol 的 MCP Server,把「代码重构」能力封装成 AI 可直接调用的工具。

支持本地 Ollama 与任意 OpenAI 兼容的云端接口两种推理后端,通过环境变量切换。

功能

暴露两个 MCP 工具:

工具参数说明
refactor_codecode(源代码)、task(重构任务描述)、language(可选,语言提示)执行代码重构,返回重构后的代码与说明
check_status无检查当前推理后端是否可用,并返回后端/模型信息

安装

bash
npm install -g workbuddy-code-refactor-connector

或直接以 npx 运行(无需全局安装):

bash
npx workbuddy-code-refactor-connector

配置

所有配置均通过环境变量读取,包内不硬编码任何密钥。

方式一:本地 Ollama(默认,代码不出本机)

bash
REFACTOR_BACKEND=ollama          # 默认值,可省略OLLAMA_HOST=http://127.0.0.1:11434OLLAMA_MODEL=deepseek-coder

方式二:云端 OpenAI 兼容接口

bash
REFACTOR_BACKEND=openaiOPENAI_BASE_URL=https://api.deepseek.com/v1OPENAI_MODEL=deepseek-flashOPENAI_API_KEY=sk-xxxxxxxxxxxx

全部环境变量

变量默认值说明
REFACTOR_BACKENDollama推理后端:ollama | openai
OLLAMA_HOSThttp://127.0.0.1:11434Ollama 服务地址
OLLAMA_MODELdeepseek-coder本地模型名
OPENAI_BASE_URLhttps://api.deepseek.com/v1OpenAI 兼容接口地址
OPENAI_MODELdeepseek-flash云端模型名
OPENAI_API_KEY无云端接口密钥(openai 后端必填)
REFACTOR_TIMEOUT_MS180000单次推理超时毫秒数(纯 CPU 本地推理较慢,默认放宽到 3 分钟)

接入 WorkBuddy

在 WorkBuddy 的连接器配置(mcp.json)中登记本服务:

json
{  "mcpServers": {    "code-refactor": {      "command": "npx",      "args": ["-y", "workbuddy-code-refactor-connector"],      "env": {        "REFACTOR_BACKEND": "ollama",        "OLLAMA_MODEL": "deepseek-coder"      }    }  }}

若使用云端后端,在 env 中补充 REFACTOR_BACKEND、OPENAI_BASE_URL、OPENAI_MODEL、OPENAI_API_KEY。

设计要点

  • 密钥零硬编码:地址、模型名、密钥全部来自环境变量。
  • 超时保护:所有工具调用都有超时上限,默认 180 秒。
  • 错误可读:任何异常都转换为可读的中文提示,不向调用方抛出原始堆栈。
  • 双后端:本地推理保障代码不出本机;云端接口用于追求更高重构质量。

许可

MIT

来源:workbuddy-connector/server/README.md,提交 53fe79b

工具

13

codegen

AI 代码生成(按次计费)

根据需求描述生成可运行的示例代码。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数styleprompt必填languagerequestId

review

AI 代码审查(按次计费)

审查代码并给出分级的修改建议。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数code必填focuslanguagerequestId

copywriter

爆款文案生成(按次计费)

小红书/抖音/公众号等多平台文案,一次给 3 个版本。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数tonebrief必填platformrequestId

translate

翻译与母语级润色(按次计费)

10 种语言,直译+润色+术语表三档输出。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数text必填styletarget必填requestId

sqlgen

SQL 生成与优化(按次计费)

按表结构生成/优化 SQL,自动拦截破坏性语句。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数schemadialectquestion必填requestId

testgen

单元测试生成(按次计费)

为核心代码生成可运行的单元测试(自动 mock 外部依赖)。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数code必填languageframeworkrequestId

docgen

技术文档生成(按次计费)

README / API 文档 / 变更日志 / 技术方案一键生成。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数source必填docTypeaudiencerequestId

resume

简历优化与岗位匹配(按次计费)

按 JD 诊断匹配度并用 STAR 结构重写(绝不虚构经历)。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数jdgoalresume必填requestId

contract

合同条款风险审查(按次计费)

标出高/中风险条款与缺失条款,并给出可替换表述。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数text必填partyrequestId

script

短视频脚本与分镜(按次计费)

开头钩子 3 版 + 分镜表 + 口播文案,可直接拍摄。按次计费:业务成功才确认扣款,内容违规、模型超时或生成失败会自动全额退款。

输入参数topic必填durationplatformrequestId

get_order

查询订单

按订单号查询一笔调用的状态、金额、耗时与失败原因。不收费。

输入参数orderNo必填

list_orders

订单列表

列出最近的调用订单,可按状态或平台过滤,用于对账。不收费。

输入参数limitstatusplatform

skill_info

技能与定价信息

返回当前技能是否上架、单次价格、支持的编程语言与免责声明。不收费。

无需输入参数。

版本历史

1
  1. v1.0.4最新Oct 18, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分