Refactoriza código heredado en código moderno e idiomático utilizando Ollama local o backends en la nube compatibles con OpenAI.
También conocido como zhouhengchang/code-refactor, code-refactor, workbuddy-code-refactor-connector
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.0.4
- Último commit
- 18 oct 2026
- Licencia
- MIT
¿Qué es Code Refactor MCP?
Refactoriza código heredado en código moderno e idiomático utilizando Ollama local o backends en la nube compatibles con OpenAI.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Code Refactor
La función principal de este MCP server es transformar código fuente heredado en versiones modernas e idiomáticas. Proporciona a los desarrolladores herramientas especializadas para automatizar el proceso de refactorización a través de un cliente de IA. Los usuarios pueden elegir entre ejecutar la inferencia localmente usando Ollama para mantener el código en su propia máquina o conectarse a interfaces en la nube compatibles con OpenAI para obtener resultados de mayor calidad.
El servidor expone la herramienta refactor_code para procesar código fuente basado en descripciones de tareas específicas e indicaciones de lenguaje, junto con una herramienta check_status para verificar la disponibilidad del backend. La configuración se gestiona totalmente mediante variables de entorno, requiriendo ajustes como OLLAMA_HOST para configuraciones locales o OPENAI_API_KEY y OPENAI_BASE_URL para conexiones en la nube. Incluye un timeout predeterminado de 180,000 milisegundos para adaptarse al procesamiento más lento de la CPU local durante tareas de refactorización pesadas.
Qué puedes hacer con él
- 1Mantener la privacidad de los datosEjecuta tareas de refactorización localmente para que tu código propietario nunca salga de tu propio hardware.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Code Refactor MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Code Refactor MCP en Claude Code
$ claude mcp add --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor -- npx -y workbuddy-code-refactor-connectorInstalar Code Refactor MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"code-refactor": {
"command": "npx",
"args": [
"-y",
"workbuddy-code-refactor-connector"
],
"env": {
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Instalar Code Refactor MCP en VS Code
.vscode/mcp.json
{
"servers": {
"code-refactor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"workbuddy-code-refactor-connector"
],
"env": {
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Instalar Code Refactor MCP en VS Code CLI
$ code --add-mcp '{"name":"code-refactor","type":"stdio","command":"npx","args":["-y","workbuddy-code-refactor-connector"],"env":{"OPENAI_API_KEY":"<YOUR_OPENAI_API_KEY>"}}'Instalar Code Refactor MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"code-refactor": {
"command": "npx",
"args": [
"-y",
"workbuddy-code-refactor-connector"
],
"env": {
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Instalar Code Refactor MCP en Codex
$ codex mcp add code-refactor --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' -- npx -y workbuddy-code-refactor-connectorInstalar Code Refactor MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.code-refactor] command = "npx" args = ["-y", "workbuddy-code-refactor-connector"] [mcp_servers.code-refactor.env] OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>"
Instalar Code Refactor MCP en Gemini CLI
$ gemini mcp add -s user -e 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor npx -- -y workbuddy-code-refactor-connectorInstalar Code Refactor MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"code-refactor": {
"command": "npx",
"args": [
"-y",
"workbuddy-code-refactor-connector"
],
"env": {
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Configuración
OPENAI_API_KEYSecretoAPI key for the cloud endpoint, e.g. a DeepSeek key. Only needed when REFACTOR_BACKEND=openai.
OLLAMA_HOSTOllama server address used when REFACTOR_BACKEND=ollama.
OLLAMA_MODELOllama model name used when REFACTOR_BACKEND=ollama.
OPENAI_BASE_URLBase URL of the OpenAI-compatible endpoint, e.g. https://api.deepseek.com/v1. Required when REFACTOR_BACKEND=openai.
OPENAI_MODELCloud model name, e.g. deepseek-chat.
REFACTOR_BACKENDInference backend: 'ollama' (local, code stays on your machine, default) or 'openai' (any OpenAI-compatible cloud endpoint, e.g. DeepSeek).
REFACTOR_TIMEOUT_MSPer-call timeout in milliseconds. Raise it for slow local CPU inference.
| Nombre | Descripción | Tipo |
|---|---|---|
| OPENAI_API_KEY | API key for the cloud endpoint, e.g. a DeepSeek key. Only needed when REFACTOR_BACKEND=openai. | Secreto |
| OLLAMA_HOST | Ollama server address used when REFACTOR_BACKEND=ollama. | |
| OLLAMA_MODEL | Ollama model name used when REFACTOR_BACKEND=ollama. | |
| OPENAI_BASE_URL | Base URL of the OpenAI-compatible endpoint, e.g. https://api.deepseek.com/v1. Required when REFACTOR_BACKEND=openai. | |
| OPENAI_MODEL | Cloud model name, e.g. deepseek-chat. | |
| REFACTOR_BACKEND | Inference backend: 'ollama' (local, code stays on your machine, default) or 'openai' (any OpenAI-compatible cloud endpoint, e.g. DeepSeek). | |
| REFACTOR_TIMEOUT_MS | Per-call timeout in milliseconds. Raise it for slow local CPU inference. |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblezhouhengchang/code-refactor is public and reachablegithub.com/zhouhengchang/code-refactor ↗Aprobado
- El paquete indica este repositorio como su origenworkbuddy-code-refactor-connector names zhouhengchang/code-refactor as sourcenpmjs.com/package/workbuddy-code-refactor-connector ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-18github.com/zhouhengchang/code-refactor ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from workbuddy-code-refactor-connectorAprobado
- No hay avisos críticos en el paquete ni en sus dependencias99 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPHTTPS endpoint answered 403 (sign-in required)Aprobado
README
Ver en GitHubworkbuddy-code-refactor-connector
WorkBuddy 代码重构连接器 —— 一个基于 Model Context Protocol 的 MCP Server,把「代码重构」能力封装成 AI 可直接调用的工具。
支持本地 Ollama 与任意 OpenAI 兼容的云端接口两种推理后端,通过环境变量切换。
功能
暴露两个 MCP 工具:
| 工具 | 参数 | 说明 |
|---|---|---|
refactor_code |
code(源代码)、task(重构任务描述)、language(可选,语言提示) |
执行代码重构,返回重构后的代码与说明 |
check_status |
无 | 检查当前推理后端是否可用,并返回后端/模型信息 |
安装
npm install -g workbuddy-code-refactor-connector
或直接以 npx 运行(无需全局安装):
npx workbuddy-code-refactor-connector
配置
所有配置均通过环境变量读取,包内不硬编码任何密钥。
方式一:本地 Ollama(默认,代码不出本机)
REFACTOR_BACKEND=ollama # 默认值,可省略
OLLAMA_HOST=http://127.0.0.1:11434
OLLAMA_MODEL=deepseek-coder
方式二:云端 OpenAI 兼容接口
REFACTOR_BACKEND=openai
OPENAI_BASE_URL=https://api.deepseek.com/v1
OPENAI_MODEL=deepseek-flash
OPENAI_API_KEY=sk-xxxxxxxxxxxx
全部环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
REFACTOR_BACKEND |
ollama |
推理后端:ollama | openai |
OLLAMA_HOST |
http://127.0.0.1:11434 |
Ollama 服务地址 |
OLLAMA_MODEL |
deepseek-coder |
本地模型名 |
OPENAI_BASE_URL |
https://api.deepseek.com/v1 |
OpenAI 兼容接口地址 |
OPENAI_MODEL |
deepseek-flash |
云端模型名 |
OPENAI_API_KEY |
无 | 云端接口密钥(openai 后端必填) |
REFACTOR_TIMEOUT_MS |
180000 |
单次推理超时毫秒数(纯 CPU 本地推理较慢,默认放宽到 3 分钟) |
接入 WorkBuddy
在 WorkBuddy 的连接器配置(mcp.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 秒。
- 错误可读:任何异常都转换为可读的中文提示,不向调用方抛出原始堆栈。
- 双后端:本地推理保障代码不出本机;云端接口用于追求更高重构质量。
许可
Preguntas sobre Code Refactor MCP
¿Cómo agrego Code Refactor MCP a Claude Code?
Ejecuta claude mcp add --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor -- npx -y workbuddy-code-refactor-connector en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Code Refactor MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo puedo asegurar que mi código se mantenga local?
Puedes usar el backend local de Ollama para garantizar que el código no salga de tu máquina.
¿Puedo usar modelos basados en la nube?
Sí, puedes usar cualquier interfaz en la nube compatible con OpenAI configurando REFACTOR_BACKEND como openai.