Skip to main content
Glama
qodercli-mcp

qodercli-mcp

qodercli-mcp

A minimal MCP server that wraps qodercli (Qoder CLI), letting any MCP client delegate coding tasks to a local Qoder agent.

シンプルな MCP server で、ローカルの qodercli(Qoder CLI)を MCP ツールとしてラップし、任意の MCP クライアント(Qoder IDE、Claude Code、Cursor など)がサブエージェントのように Qoder を呼び出せるようにします。

Why / なぜ

Some CLI agents ship an official MCP server mode (e.g. codex mcp-server), but qodercli currently only acts as an MCP client. This project fills that gap with a thin wrapper: it spawns qodercli -p <prompt> under the hood and streams the result back over MCP stdio.

一部の CLI Agent は公式の MCP server モードを提供しています(例:codex mcp-server)が、qodercli は現在 MCP クライアントとしてのみ機能します。このプロジェクトは薄いラッパーでそのギャップを埋めます:内部で qodercli -p <prompt> を起動し、結果を MCP stdio を介してストリーム返します。

Related MCP server: github-copilot-cli-mcp-server

Features / 機能

  • ask-qoder tool — delegate a prompt to qodercli

  • ask-qoder ツール —— タスクを qodercli に委任する

  • Structured output (session_id, is_error, duration_ms, total_credits, num_turns) via -o json parsing

  • 構造化出力(session_id、is_error、duration_ms、total_credits、num_turns)、-o json を自動解析

  • list-sessions tool to discover resumable sessions

  • list-sessions ツール、再開可能なセッションを発見する

  • list-models tool for runtime model discovery (no stale model lists)

  • list-models ツール、実行時に利用可能なモデルを発見(古いリストに依存しない)

  • reasoning_effort parameter (--reasoning-effort)

  • reasoning_effort パラメータ(--reasoning-effort を透過)

  • Server instructions in the MCP initialize result guide clients on usage

  • MCP initialize 結果にサーバー使用説明が含まれ、クライアントの正しい呼び出しを導く

  • Codex-style sandbox levels (read-only / workspace-write / danger-full-access)

  • codex スタイルの sandbox レベル(read-only / workspace-write / danger-full-access)

  • System prompt injection (system_prompt / append_system_prompt)

  • システムプロンプト注入(system_prompt / append_system_prompt)

  • Working directory, model, permission mode, output format control

  • 作業ディレクトリ、モデル、権限モード、出力フォーマットの指定をサポート

  • Session resume (resume_session_id) for multi-turn delegation

  • セッション再開(resume_session_id)をサポートし、マルチターン委任が可能

  • Timeout protection with SIGKILL fallback

  • タイムアウト保護(タイムアウト時に自動 SIGKILL)

  • Proxy quota support (HTTP_PROXY / HTTPS_PROXY injection)

  • プロキシクォータサポート(HTTP_PROXY / HTTPS_PROXY の注入)

  • Zero build step — plain ESM JavaScript, Node.js >= 18

  • ビルド不要 —— プレーンな ESM JavaScript、Node.js >= 18

Prerequisites / 前提条件

  1. Node.js >= 18

  2. qodercli installed and signed in (qodercli login)

Install / インストール

Option A — npx (recommended / 推奨): no clone needed, the MCP client downloads the package on first use. クローン不要、MCP クライアントが初回使用時に自動ダウンロード:

"command": "npx", "args": ["-y", "qodercli-mcp"]

Option B — from source (for development / 開発用):

git clone https://github.com/cantbeblank96/qodercli-mcp.git
cd qodercli-mcp
npm install

MCP client configuration / MCP クライアント設定

Qoder IDE

Add to ~/.qoder/mcp.json. Prefer the absolute path of node and set QODERCLI_PATH explicitly (nvm-managed binaries are often missing from the PATH seen by MCP child processes):

Proxy Support: To use your Qoder CLI proxy quota, add HTTP_PROXY and/or HTTPS_PROXY to the server's environment. When these are set at the MCP server level, they will be passed to all qodercli subprocesses.

~/.qoder/mcp.json に追加します。node の絶対パスを使用し、QODERCLI_PATH を明示的に設定することを推奨します(MCP 子プロセスの PATH には nvm 管理のバイナリがしばしば含まれていません):

プロキシサポート:Qoder CLI プロキシクォータを使用するには、サーバーの環境変数に HTTP_PROXY および/または HTTPS_PROXY を追加します。これらの変数が MCP サーバーレベルで設定されると、すべての qodercli 子プロセスに渡されます。

{
  "mcpServers": {
    "qodercli-mcp": {
      "command": "npx",
      "args": ["-y", "qodercli-mcp"],
      "env": {
        "QODERCLI_PATH": "/absolute/path/to/qodercli",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    },
    "qodercli-mcp-with-proxy": {
      "command": "npx",
      "args": ["-y", "qodercli-mcp"],
      "env": {
        "QODERCLI_PATH": "/absolute/path/to/qodercli",
        "HTTP_PROXY": "http://127.0.0.1:39900",
        "HTTPS_PROXY": "http://127.0.0.1:39900",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Developers running a local checkout instead of the published package (Option B) should replace command/args with the absolute node path and /path/to/qodercli-mcp/src/index.js (nvm-managed node is often missing from the PATH seen by MCP child processes). ローカルソース(方式 B)を使用する開発者は、command/args を node の絶対パスと /path/to/qodercli-mcp/src/index.js に置き換えてください(MCP 子プロセスの PATH には nvm 管理のバイナリがしばしば含まれていません)。

Claude Code / Claude Desktop

{
  "mcpServers": {
    "qodercli-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/qodercli-mcp/src/index.js"],
      "env": {
        "QODERCLI_PATH": "/absolute/path/to/qodercli"
      }
    }
  }
}

Tool: ask-qoder

Parameter

Type

Description

prompt

string (required)

The task or question for qodercli / qodercli に渡すタスクまたは質問

cwd

string

Working directory / 作業ディレクトリ

model

string

Model for this session; call list-models to discover available names / このセッションで使用するモデル。まず list-models で確認

reasoning_effort

string

Reasoning effort level (--reasoning-effort), e.g. low/medium/high; depends on the model / 推論の強度、モデルに依存

permission_mode

enum

dont_ask (default, read-only) | accept_edits (auto-approve file edits) | bypass_permissions (full access incl. shell) | auto | default; mutually exclusive with approval_policy, prefer sandbox / approval_policy と排他的、sandbox 推奨

approval_policy

enum

codex-style: untrusted→read-only | on-request→auto | never→full access / codex スタイルの承認ポリシー、自動マッピング

sandbox

enum

read-only | workspace-write | danger-full-access (codex-style; controls the effective permission mode) / 実際の権限レベルを制御

system_prompt

string

Replace the default system prompt / デフォルトのシステムプロンプトを置き換える

append_system_prompt

string

Append instructions to the default system prompt / システムプロンプトを追加

resume_session_id

string

Resume a previous session / 以前のセッションを再開

output_format

string

Passed to -o (default json) / -o に渡される(デフォルトは json)。注:非 json 形式では構造化出力が低下します(session_id などが利用不可になる)/ 非 json 形式では構造化フィールドが無効になる

extra_args

string[]

Raw CLI args appended before the prompt; reserved flags (permission mode, system prompt, model, -o, -r, -w...) are rejected / 未加工の CLI 引数をプロンプトの前に追加;予約フラグは拒否される

timeout_ms

number

Timeout in ms, default 600000 / タイムアウト(ミリ秒)、デフォルト 600000

Structured output / 構造化出力

ask-qoder declares an MCP outputSchema and returns, in addition to the human-readable text, a structuredContent object:

ask-qoder は MCP outputSchema を宣言し、人間が読めるテキストに加えて structuredContent オブジェクトを返します:

{
  "session_id": "77826b5c-...",   // pass back as resume_session_id / 回传用于续接
  "content": "OK",
  "is_error": false,
  "exit_code": 0,
  "duration_ms": 1280,
  "total_credits": 0.53,
  "num_turns": 1,
  "timed_out": false,
  "truncated": false
}

Sandbox mapping / サンドボックスマッピング

sandbox

Effective permission mode / 実際の権限モード

Effect on qodercli / qodercli への効果

(omitted / 省略)

dont_ask

Read-only: permission-requiring tools are silently denied / 読み取り専用:権限が必要なツール呼び出しは静かに拒否される

read-only

dont_ask

Plus --disallowed-tools write_file,replace,run_shell_command as defense in depth / さらに防御策として --disallowed-tools write_file,replace,run_shell_command を追加し、書き込み/shell ツールを無効化、二重の保険

workspace-write

accept_edits

Agent can create/modify files in cwd / エージェントは cwd 内でファイルを作成/変更可能

danger-full-access

bypass_permissions

Full access including shell / 完全なアクセス(シェル含む)

Explicit permission_mode or approval_policy always wins over sandbox. 明示的に設定された permission_mode / approval_policy は sandbox より優先されます。

Permission modes (verified semantics) / 権限モード(実測セマンティクス)

Mode

Behavior / 動作

dont_ask

Read-only: silently denies every tool call that requires permission. Headless-safe default / 読み取り専用:権限が必要なすべてのツール呼び出しを静かに拒否。ヘッドレスセーフなデフォルト

accept_edits

Auto-approves file edits; shell still governed by policy / ファイル編集を自動承認

bypass_permissions

Auto-approves everything including shell / すべてを自動承認(シェル含む)

auto

qodercli's own automatic policy / qodercli の自動ポリシー

default

Interactive confirmation — not headless-friendly, avoid in MCP calls / 対話的な確認 — ヘッドレスに不向き、MCP 呼び出しでは避ける

Tool: list-sessions

Lists local qodercli sessions (index, summary, session id) so a client can pick a resume_session_id. Takes no arguments.

ローカルの qodercli セッション(インデックス、サマリー、セッション ID)を一覧表示し、resume_session_id を選択しやすくします。引数なし。

Tool: list-models

Lists models currently supported by qodercli (via --list-models), so a client can pick a valid model value at runtime instead of relying on stale knowledge. Returns both a text list and a structured models array. Takes no arguments.

qodercli が現在サポートしているモデルを一覧表示し、実行時に有効な model 値を選択できるようにします(古い知識に依存しない)。テキストリストと構造化された models 配列を返します。引数なし。

Usage Examples / 使用例

Example 1: Simple code explanation / シンプルなコード説明

{ "name": "ask-qoder", "arguments": { 
  "prompt": "Explain what main.py does",
  "cwd": "/path/to/project",
  "timeout_ms": 180000 
}}

結果は自然言語の説明を返し、ファイルの機能を理解するのに役立ちます。

Example 2: Ask a second opinion / セカンドオピニオンを得る

{ "name": "ask-qoder", "arguments": { 
  "prompt": "@src/service.py Review this file for security issues and suggest improvements",
  "model": "qwen-plus",
  "permission_mode": "dont_ask",
  "timeout_ms": 300000 
}}

Qoder はセキュリティアドバイスと改善案を提供します。

Example 3: Multi-turn conversation via resume / 再開によるマルチターン会話

// First call — session_id comes back in structuredContent
// 首次调用 —— session_id 会在 structuredContent 中返回
{ "name": "ask-qoder", "arguments": {
  "prompt": "Help me refactor this module to improve readability",
  "cwd": "/projects/backend",
  "timeout_ms": 300000 
}}
// Then reuse structuredContent.session_id:
// 然后把 structuredContent.session_id 回传:
{ "name": "ask-qoder", "arguments": {
  "prompt": "Now add error handling for database timeouts",
  "resume_session_id": "77826b5c-cd6b-4213-b423-d95b4e1deab0"
}}
// Or discover ids with list-sessions / 或用 list-sessions 查找历史会话 ID
{ "name": "list-sessions", "arguments": {} }

resume_session_id を使用することで、マルチターンの対話型反復最適化が可能です。

Example 4: Code review with specific focus / 特定の焦点を当てたコードレビュー

{ "name": "ask-qoder", "arguments": {
  "prompt": "Analyze performance bottlenecks in utils.py",
  "model": "qwen-max",
  "permission_mode": "default",
  "output_format": "text",
  "timeout_ms": 240000 
}}

パフォーマンス分析や最適化提案のシナリオに適しています。

Example 5: Read-only analysis / 読み取り専用分析

{ "name": "ask-qoder", "arguments": {
  "prompt": "Audit this codebase for security issues; do not modify anything",
  "cwd": "/workspaces/repo",
  "sandbox": "read-only",
  "timeout_ms": 300000 
}}

read-only はファイル書き込みとシェルツールを無効にし、監査/レビューシナリオに適しています。

Example 6: Project-wide analysis / プロジェクト全体分析

{ "name": "ask-qoder", "arguments": {
  "prompt": "Summarize the architecture of this project and identify key modules",
  "cwd": "/workspaces/repo",
  "timeout_ms": 420000,
  "model": "qwen-plus"
}}

大規模プロジェクトの迅速な整理とアーキテクチャ理解に適しています。

Best Practices / ベストプラクティス

  1. Specify working directory — Always pass cwd when operating on a specific project 操作特定项目时务必指定 cwd

  2. Use timeout protection — For complex prompts, set explicit timeout_ms shorter than 60min 複雑なタスクには timeout_ms(5~10 分推奨)を設定し、ハングアップを防ぐ

  3. Resume for multi-turn — Chain follow-ups via resume_session_id instead of repeating context 後続の質問は resume_session_id でセッションを継続し、コンテキストの重複を避ける

  4. Model selection — Call list-models first to discover currently supported models; larger models are better for deep analysis 先に list-models を呼び出して現在利用可能なモデルを確認する。深い分析には大規模モデルを推奨

  5. Permission mode — The server default is read-only (dont_ask); set QODERCLI_DEFAULT_PERMISSION_MODE=bypass_permissions to make full (YOLO) access the default for personal deployments. Per-call: tasks that must create/modify files need sandbox: "workspace-write"; shell access needs danger-full-access. Do not combine sandbox with an explicit permission_mode (the latter wins) サーバーのデフォルトは読み取り専用(dont_ask)。個人デプロイでは QODERCLI_DEFAULT_PERMISSION_MODE=bypass_permissions を設定してフルアクセス(YOLO)をデフォルトにできる。呼び出しごと:ファイル作成・変更が必要なタスクは sandbox: "workspace-write"、シェルアクセスが必要な場合は danger-full-access を設定。sandbox と明示的な permission_mode は併用不可(後者が優先)

Environment variables / 環境変数

Variable

Default

Description

QODERCLI_PATH

qodercli

Path to the qodercli binary / qodercli バイナリのパス

QODERCLI_TIMEOUT_MS

600000

Default timeout / デフォルトのタイムアウト

QODERCLI_MAX_OUTPUT_MB

50

Per-call stdout/stderr cap in MB (OOM protection) / 呼び出しごとの出力上限(MB、OOM 対策)

QODERCLI_DEFAULT_PERMISSION_MODE

dont_ask

Default permission mode when the caller omits permission_mode/approval_policy/sandbox; set bypass_permissions for full (YOLO) access / 呼び出し元が権限パラメータを省略した場合のデフォルトモード。bypass_permissions を設定するとフルアクセス(YOLO)になる

HTTP_PROXY

-

HTTP proxy URL for qodercli / qodercli の HTTP プロキシ URL

HTTPS_PROXY

-

HTTPS proxy URL for qodercli / qodercli の HTTPS プロキシ URL

Development / 開発

npm test        # smoke test: protocol handshake + tool invocation
node src/index.js   # run the server manually (stdio)

Disclaimer / 免責事項

This is an unofficial, third-party tool. It is not affiliated with, endorsed, or sponsored by Qoder. Use permission_mode: bypass_permissions with care — delegated prompts may modify files in the target working directory.

本ツールは非公式のサードパーティ製であり、Qoder とは提携・承認・支援関係にありません。bypass_permissions 権限モードは注意して使用してください。委任されたプロンプトは対象の作業ディレクトリ内のファイルを変更する可能性があります。

License

MIT

Available Tools

3 tools
ask-qoderA

Delegate a task to qodercli (Qoder CLI), a local agentic coding assistant. Use it to get a second opinion, a code review, or to have Qoder perform a self-contained coding task in a given working directory. Returns structured output including session_id; pass it back as resume_session_id to continue the conversation.

Inputs: prompt (required), cwd, model, sandbox, +9 more. Returns: content, is_error, exit_code, num_turns, +5 more

list-modelsA

List models currently supported by qodercli. Use this before picking a model name for ask-qoder.

Inputs: no named parameters. Returns: models, content

list-sessionsA

List local qodercli sessions (index + id + summary) so you can pick a resume_session_id for ask-qoder.

Inputs: no named parameters. Returns: content

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: ask-qoder for delegating tasks, list-sessions for managing sessions, and list-models for model selection. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (ask-qoder, list-sessions, list-models), making them predictable and easy to understand.

    Tool Count5/5

    Three tools is appropriate for a CLI wrapper MCP server, covering the core interactions (task execution, session management, model listing) without unnecessary bloat.

    Completeness5/5

    The tool set covers the essential workflows for qodercli: initiating tasks, resuming sessions, and selecting models. No obvious gaps for its intended purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers