Yerel Ollama veya OpenAI uyumlu bulut backend'lerini kullanarak eski kodları modern ve idiomatik kodlara dönüştürür.
Ayrıca bilinen adı zhouhengchang/code-refactor, code-refactor, workbuddy-code-refactor-connector
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.0.4
- Son commit
- 18 Eki 2026
- Lisans
- MIT
Code Refactor MCP nedir?
Code Refactor bir MCP sunucusudur. Yerel Ollama veya OpenAI uyumlu bulut backend'lerini kullanarak eski kodları modern ve idiomatik kodlara dönüştürür.
Özet, projenin README dosyasından oluşturuldu
Code Refactor MCP sunucusu hakkında
Eski kaynak kodları modern ve idiomatik versiyonlara dönüştürmek, bu MCP server'ın temel işlevidir. Geliştiricilere, bir AI istemcisi aracılığıyla refactoring sürecini otomatikleştirmeleri için özelleşmiş araçlar sunar. Kullanıcılar, kodları kendi makinelerinde tutmak için Ollama kullanarak çıkarımı yerel olarak çalıştırma veya daha yüksek kaliteli sonuçlar için bulut tabanlı OpenAI uyumlu arayüzlere bağlanma arasında seçim yapabilirler.
Server, belirli görev açıklamalarına ve dil ipuçlarına göre kaynak kodu işlemek için refactor_code aracını, backend kullanılabilirliğini doğrulamak için ise check_status aracını sunar. Yapılandırma tamamen ortam değişkenleri (environment variables) üzerinden yönetilir; yerel kurulumlar için OLLAMA_HOST, bulut bağlantıları için ise OPENAI_API_KEY ve OPENAI_BASE_URL gibi ayarlar gereklidir. Yoğun refactoring görevleri sırasında daha yavaş çalışan yerel CPU işlemlerine uyum sağlamak için varsayılan 180,000 milisaniyelik bir zaman aşımı süresi içerir.
Neler yapabilirsiniz
- 1Veri gizliliğini koruyunÖzel kodlarınızın donanımınızdan asla çıkmaması için refactoring görevlerini yerel olarak çalıştırın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Code Refactor MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleCode Refactor MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor -- npx -y workbuddy-code-refactor-connectorCode Refactor MCP'yi Cursor içine yükleyin
~/.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'yi VS Code içine yükleyin
.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'yi VS Code CLI içine yükleyin
$ 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'yi Claude Desktop içine yükleyin
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'yi Codex içine yükleyin
$ codex mcp add code-refactor --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' -- npx -y workbuddy-code-refactor-connectorCode Refactor MCP'yi Codex config.toml içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor npx -- -y workbuddy-code-refactor-connectorCode Refactor MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"code-refactor": {
"command": "npx",
"args": [
"-y",
"workbuddy-code-refactor-connector"
],
"env": {
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}Yapılandırma
OPENAI_API_KEYGizliAPI 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.
| Ad | Açıklama | Sunucu |
|---|---|---|
| OPENAI_API_KEY | API key for the cloud endpoint, e.g. a DeepSeek key. Only needed when REFACTOR_BACKEND=openai. | Gizli |
| 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. |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirzhouhengchang/code-refactor is public and reachablegithub.com/zhouhengchang/code-refactor ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorworkbuddy-code-refactor-connector names zhouhengchang/code-refactor as sourcenpmjs.com/package/workbuddy-code-refactor-connector ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-18github.com/zhouhengchang/code-refactor ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from workbuddy-code-refactor-connectorGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok99 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorHTTPS endpoint answered 403 (sign-in required)Geçti
workbuddy-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 soruları
Code Refactor MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' code-refactor -- npx -y workbuddy-code-refactor-connector komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Code Refactor MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Kodlarımın yerelde kalmasını nasıl sağlayabilirim?
Kodların makinenizden çıkmadığından emin olmak için yerel Ollama backend'ini kullanabilirsiniz.
Bulut tabanlı modeller kullanabilir miyim?
Evet, REFACTOR_BACKEND değerini openai olarak ayarlayarak herhangi bir OpenAI uyumlu bulut arayüzünü kullanabilirsiniz.