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 分