Code Refactor

workbuddy-code-refactor-connector

WorkBuddy コードリファクタリングコネクター —— Model Context Protocol に基づく MCP サーバーです。「コードリファクタリング」機能を、AI が直接呼び出せるツールとして提供します。

ローカル Ollama と任意の OpenAI 互換クラウド API の2種類の推論バックエンドに対応しており、環境変数で切り替えられます。

機能

2つの MCP ツールを公開します。

ツール	パラメーター	説明
refactor_code	code（ソースコード）、task（リファクタリングタスクの説明）、language（任意、言語のヒント）	コードをリファクタリングし、リファクタリング後のコードと説明を返します
check_status	なし	現在の推論バックエンドが利用可能か確認し、バックエンド／モデルの情報を返します

インストール

npm install -g workbuddy-code-refactor-connector

または、npx で直接実行できます（グローバルインストールは不要です）。

npx workbuddy-code-refactor-connector

設定

すべての設定は環境変数から読み込み、パッケージ内にキーをハードコードしていません。

方法 1：ローカル Ollama（デフォルト、コードはローカルマシンから送信されません）

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

方法 2：クラウド OpenAI 互換 API

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 互換 API のアドレス
OPENAI_MODEL	deepseek-flash	クラウドモデル名
OPENAI_API_KEY	なし	クラウド API のキー（openai バックエンドでは必須）
REFACTOR_TIMEOUT_MS	180000	1回の推論のタイムアウト（ミリ秒）。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秒です。
• 読みやすいエラー：例外はすべて読みやすい日本語のメッセージに変換し、呼び出し元に元のスタックトレースを返しません。
• 2種類のバックエンド：ローカル推論ではコードがローカルマシンから送信されず、クラウド API はより高品質なリファクタリングを求める場合に使用できます。

ライセンス

MIT