workbuddy-mcp

あらゆる AI コーディングエージェントが WorkBuddy をサブエージェントとして操值できるようにします — 1 コマンドでインストールでき、4 つのクライアントに対応します。 あらゆる AI プログラミングアシスタント（Claude Code / Codex / Cursor / OpenCode）が WorkBuddy を「サブエージェント」として呼び出せます — 1 コマンドでセットアップ完了、4 大クライアントで利用可能です。

[(LICENSE) [(https://github.com/LinHaiJ/workbuddy-mcp) [(package.json) [(https://github.com/LinHaiJ/workbuddy-mcp/actions/workflows/smoke.yml)

English · 简体中文

機能概要 / 何をするか

workbuddy-mcp は、公式の WorkBuddy CLI（codebuddy） をラップする小さな MCP（Model Context Protocol）サーバーです。単一のツール run_workbuddy_task を公開するだけで、MCP 対応エージェントならどれでも、アプ間でコピーペーストせずに実作業を WorkBuddy に委任できます。

workbuddy-mcp は、極小な MCP（モデルコンテキストプロトコル）サーバーであり、公式の WorkBuddy CLI（codebuddy） をラップしています。単一のツール run_workbuddy_task だけを公開し、MCP をサポートするあらゆるエージェントが、複数のアプ間でコピーペーストすることなしに、実タスクを WorkBuddy に委任できます。

MCP を理解する必要はありません: npx -y workbuddy-mcp --install がインストール済みのエージェントを検出してサーバーを登録してくれます。

MCP を理解する必要はありません: 一つの npx -y workbuddy-mcp --install で、インストール済みのエージェントを自動検出して登録してくれます。

Related MCP server: all-agents-mcp

目次 / 目次

• アーキテクチャ / アーキテクチャ

• 機能 / 特性

• クイックスタート / クイックスタート

• インストール / インストール

• 使ひ方 / 使ひ方

• 設定 / 設定

• セキュリティ注意 / セキュリティ注意

• なぜ / なぜ作ったのか

• FAQ

• ロードマップ / ロードマップ

• コントリビューション / 貢献

• ライセンス / ライセンス

アーキテクチャ / アーキテクチャ

Your agent (Claude Code / Codex / Cursor / OpenCode)
      │  calls MCP tool: run_workbuddy_task(prompt)
      ▼
workbuddy-mcp   (this server, stdio MCP)
      │  shells out:
      ▼
codebuddy -p "<prompt>" --dangerously-skip-permissions
      │
      ▼
WorkBuddy   (does the actual work, returns text)

機能 / 特性

クイックスタート / クイックスタート

前提条件: WorkBuddy CLI を一度だけインストールしてログインしてください（対話形式のログインフローが開きます）。 前提: 先に WorkBuddy CLI をインストールして一度だけログインします（1 回だけで、ログインフローが開きます）。

# 1. Install & log in the WorkBuddy CLI
npm install -g @tencent-ai/codebuddy-code
codebuddy -p "hello" --dangerously-skip-permissions   # first run opens a login flow

# 2. Install the MCP server into every agent you have
npx -y workbuddy-mcp --install

その後、任意のエージェントで「workbuddy を使って data.csv を読み、週次レポートを下書きして」のように言うだけで、エージェントが代わりに run_workbuddy_task を呼び出します。

そして、任意の Agent で「workbuddy に data.csv を読ませて週報を書かせる」と言うだけで、Agent が自動的に run_workbuddy_task を呼び出します。

インストール / インストール

オプション A — 1 コマンド（推奨）

npx -y workbuddy-mcp --install

マシン上の Claude Code / Codex / Cursor / OpenCode を検出して、サーバーを登録します。新しいエージェントをインストールしたら再実行してください。

オプション B — npm から取得してからインストール

npm install -g workbuddy-mcp
workbuddy-mcp --install

オプション C — 手動（任意の MCP クライアント） クライアントを node <path>/server.js に指定します。例:

Claude Code

claude mcp add -s user workbuddy -- node /abs/path/to/workbuddy-mcp/server.js

Codex

codex mcp add workbuddy -- node /abs/path/to/workbuddy-mcp/server.js

Cursor — ~/.cursor/mcp.json に書き込む:

{ "mcpServers": { "workbuddy": { "command": "node", "args": ["/abs/path/to/workbuddy-mcp/server.js"] } } }

OpenCode — opencode.json に書き込む（プロジェクトルートまたは ~/.config/opencode/opencode.json）:

{ "mcp": { "workbuddy": { "type": "local", "command": ["node", "/abs/path/to/workbuddy-mcp/server.js"], "enabled": true } } }

cwd / WB_* 環境変数が設定済みですぐ使えるテンプレートは、opencode.json.example を参照してください。

使い方 / 使い方

サーバーは1 つのツールを公開します。エージェントが代わりに呼び出しますが、直接呼び出すこともできます。

// Tool: run_workbuddy_task
{
  prompt: "读取 ./reports 下的 CSV，生成一份中文月度总结",  // required 必填
  cwd:    "/path/to/your/project",   // optional 可选: where WorkBuddy reads/writes files
  model:  "sonnet",                  // optional 可选: model alias
  json:   true                       // optional 可选: request --output-format json
}

エージェントに渡すような指示の例:

• 「workbuddy にリポジトリのルートディレクトリでテストを実行させ、失敗ログを Markdown にまとめさせて」

• 「workbuddy を使って src/utis.ts をリファクタリングし、変更内容を説明して」

ファイルはどこに保存される？ テキストでの回答はチヤットに返ってきます。WorkBuddy が書き込むファイルは、その cwd（呼び出しの cwd → なければ WB_CWD → なければエージェントの作業フォルダ）に置かれます。エージェントのコンテキストには自動追加されないので、ディスクから読み取ってください。

設定 / 設定

すべての調整は環境変数で行います。エージェントの MCP 設定の environment ブロックに設定してください。

モデル切リ替え / モデル切リ替え

codebuddy CLI は --model <id> と --fallback-model <id> を公開しています（後者は --print のときのみ有効で、このサーバーは常に --print を使います）。このサーバーはその両方を利用可能にします:

• 呼び出しごと — run_workbuddy_task に model または fallbackModel を渡します。

• グローバル — エージェントの MCP environment ブロックで WB_MODEL / WB_FALLBACK_MODEL を設定します。呼び出しで渡されない場合に適用されます。

利用可能なモデル（codebuddy --help より）: auto、hy3、hy3-x、glm-5.3、glm-5.2、glm-5.1、glm-5v-turbo、minimax-m3、kimi-k3-1、kimi-k2.7、kimi-k2.6、deepsek-v4-flah、deepsek-v4-pro。

無料モデルでレート制限に遭った？ ハードに切リ替えず、フォールバックを追記してください。hy3 をプライマリに保ちつつ、過負荷時に自動復帰します:

// opencode.json / claude mcp config environment
{
  "WB_MODEL": "hy3",
  "WB_FALLBACK_MODEL": "deepseek-v4-flash"
}

または呼び出しごと: run_workbuddy_task({ promt: "...", fallbackModel: "deepsek-v4-flah" })。

モデル切リ替え / モデル切リ替え

codebuddy は --model <id> と --fallback-model <id> を備えています（--fallback-model は --print のときのみ有効で、本サービスは常に - を使うため利用可能です）。本サービスはその両方を公開しています:

• 単回呼び出し: run_workbuddy_task に model や fallbackModel を渡します。

• グローバルデフォルト: Agent の MCP environment で WB_MODEL / WB_FALLBACK_MODEL を設定し、呼び出しで渡されない場合に使います。

無料モデルがレート制限を受けた場合は、無理に切リ替えずフォールバックを追記することをおすすめします。hy3 を引き続き優先し、過負荷時には deepsek-v4-flah などに自動で切リ替え、レート制限が回復すると再び hy3 に自動で戻ります。

セキュリティ注意 / セキュリティ注意

デフォルトでは WB_SKIP_PERMISSIONS=true で、codebuddy は対話的な権限プロンプとなしで実行されます。これによりエージェントが無人で操值できるようになりますが、エージェントが要求した操值がすべて自動的に実行されることも意味します。個人用の信頼できる自動化では問題ありませんが、人間の確認を挟みたい場合は、MCP 設定で WB_SKIP_PERMISSIONS=false に設定してください。

デフォルトでは WB_SKIP_PERMISSIONS=true、つまり codebuddy は対話的な承認をスキップして自動実行します。これは「エージェントに無人で操作させる」ために必要なことです。しかし、エージェントが要求したあらゆる操作が自動実行されることも意味します。個人の信頼できる自動化シナリオでは問題ありませんが、人間の確認を残したい場合は WB_SKIP_PERMISSIONS を false に設定してください。

なぜ / なぜこれを作ったのか

WorkBuddy は高性能なエージェントですが、各プロダクト（Claude Code、Codex、Cursor、OpenCode…）はそれぞれ別の箱の中にあります。それらのプロダクトが WorkBuddy をサブエージェントとして利用できるようにする公式の「リバース MCP」は存在しません。このプロジェクトはその薄い接着剤です。WorkBuddy 自身の CLI を標準的な MCP ツールの背後にパッケージし、4 つの最も人気のあるコーディングエージェントが 1 つの WorkBuddy を共有できるようにします。

WorkBuddy 自体の能力は非常に高いですが、Claude Code、Codex、Cursor、OpenCode はそれぞれ孤立しており、公式にはこれらの製品が WorkBuddy を子エージェントとして呼び出すための「リバース MCP」は提供されていません。このプロジェクトはまさにその薄い接着剤です。WorkBuddy 自身のコマンドラインを標準的な MCP ツールにラップし、最も主流なプログラミングエージェントが同じ WorkBuddy を共有できるようにします。

FAQ

WorkBuddy デスクトップアプリの実行は必要ですか? いいえ。スタンドアロンの codebuddy CLI（同じエンジンのターミナル版）を操作します。デスクトップでのログインが 1 回あれば十分です。

オフラインで動作しますか? MCP サーバーはローカルですが、codebuddy の呼び出しは WorkBuddy のサービスに到達するため、実際のタスクにはインターネット接続が必要です。

WorkBuddy デスクトップのチャットにエージェントが依頼した内容は表示されますか? codebuddy は独自のセッションとして実行されるため、会話がデスクトップアプリの履歴に表示されない場合があります。これは想定どおりです。

ロードマップ / ロードマップ

• Claude Code / Codex / Cursor / OpenCode 向けの自動インストール

• ストリーミング出力（完全な結果を待たずに進捗を表示）

• オプションの構造化 JSON 結果の解析

• codebuddy が見つからない場合 → ガイド付きインストールのヒント

コントリビューション / 貢献

PR やアイデアを歓迎します! good first issue ラベルの付いた Issue が始めやすいです。CONTRIBUTING.md を参照してください。

すべての push / PR でスモークテスト（.github/workflows/smoke.yml）が実行され、Node 18/20/22 での構文チェックと、サーバーが MCP の initialize → tools/list ハンドシェイクを完了できることを検証します。ローカルで実行するには:

push / PR のたびにスモークテスト（.github/workflows/smoke.yml）が実行され、Node 18/20/22 で構文をチェックし、サーバーが MCP の initialize → tools/list ハンドシェイクを完了できることを検証します。ローカルでの自測:

npm install
node test/smoke.mjs

PR やアイデアを歓迎します! good first issue ラベルの付いたイシューから始められます。

ライセンス / ライセンス

MIT © LinHaiJ。詳細は LICENSE を参照してください。