Рефакторинг устаревшего кода в современный и идиоматичный с использованием локального Ollama или облачных бэкендов, совместимых с OpenAI.
Также известен как zhouhengchang/code-refactor, code-refactor, workbuddy-code-refactor-connector
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 1.0.4
- Последний коммит
- 18 окт. 2026 г.
- Лицензия
- MIT
Что такое Code Refactor MCP?
Рефакторинг устаревшего кода в современный и идиоматичный с использованием локального Ollama или облачных бэкендов, совместимых с OpenAI.
Сводка сгенерирована из README проекта
О Code Refactor MCP server
Основная функция этого MCP server заключается в преобразовании устаревшего исходного кода в современные идиоматичные версии. Он предоставляет разработчикам специализированные инструменты для автоматизации процесса рефакторинга через AI-клиент. Пользователи могут выбирать между локальным запуском инференса через Ollama, чтобы код оставался на их устройстве, или подключением к облачным интерфейсам, совместимым с OpenAI, для получения более качественных результатов.
Сервер предоставляет инструмент refactor_code для обработки исходного кода на основе описаний задач и подсказок по языку программирования, а также инструмент check_status для проверки доступности бэкенда. Конфигурация полностью осуществляется через переменные окружения: для локальной настройки требуется OLLAMA_HOST, а для облачных подключений — OPENAI_API_KEY и OPENAI_BASE_URL. В систему включен таймаут по умолчанию в 180,000 миллисекунд, чтобы компенсировать более медленную работу локального CPU при выполнении тяжелых задач по рефакторингу.
Что вы можете с ним делать
- 1Поддержание конфиденциальности данныхЗапускайте задачи по рефакторингу локально, чтобы ваш проприетарный код никогда не покидал ваше оборудование.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Code Refactor MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Code Refactor MCP в Claude Code
$ claude mcp add --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor -- npx -y workbuddy-code-refactor-connectorУстановка Code Refactor MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"code-refactor": {
"command": "npx",
"args": [
"-y",
"workbuddy-code-refactor-connector"
],
"env": {
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Установка Code Refactor MCP в 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>"
}
}
}
}Установка Code Refactor MCP в 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>"}}'Установка Code Refactor MCP в 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>"
}
}
}
}Установка Code Refactor MCP в Codex
$ codex mcp add code-refactor --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' -- npx -y workbuddy-code-refactor-connectorУстановка Code Refactor MCP в 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>"
Установка Code Refactor MCP в Gemini CLI
$ gemini mcp add -s user -e 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor npx -- -y workbuddy-code-refactor-connectorУстановка Code Refactor MCP в 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>"
}
}
}
}Конфигурация
OPENAI_API_KEYСекретAPI 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.
| Название | Описание | Тип |
|---|---|---|
| OPENAI_API_KEY | API key for the cloud endpoint, e.g. a DeepSeek key. Only needed when REFACTOR_BACKEND=openai. | Секрет |
| 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. |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийzhouhengchang/code-refactor is public and reachablegithub.com/zhouhengchang/code-refactor ↗Пройдено
- Пакет указывает этот репозиторий как источникworkbuddy-code-refactor-connector names zhouhengchang/code-refactor as sourcenpmjs.com/package/workbuddy-code-refactor-connector ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-18github.com/zhouhengchang/code-refactor ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from workbuddy-code-refactor-connectorПройдено
- Нет критических предупреждений в пакете или его зависимостях99 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPHTTPS endpoint answered 403 (sign-in required)Пройдено
README
Открыть на 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 秒。
- 错误可读:任何异常都转换为可读的中文提示,不向调用方抛出原始堆栈。
- 双后端:本地推理保障代码不出本机;云端接口用于追求更高重构质量。
许可
Вопросы о Code Refactor MCP
Как добавить Code Refactor MCP в Claude Code?
Выполните claude mcp add --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor -- npx -y workbuddy-code-refactor-connector в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Code Refactor MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Как обеспечить локальное хранение кода?
Вы можете использовать локальный бэкенд Ollama, чтобы гарантировать, что код не покинет вашу машину.
Можно ли использовать облачные модели?
Да, вы можете использовать любой облачный интерфейс, совместимый с OpenAI, установив REFACTOR_BACKEND в значение openai.