Skip to main content
Glama
qodercli-mcp

qodercli-mcp

qodercli-mcp

Ein minimaler MCP-Server, der qodercli (Qoder CLI) umschließt und jedem MCP-Client ermöglicht, Codierungsaufgaben an einen lokalen Qoder-Agenten zu delegieren.

Ein minimaler MCP-Server, der das lokale qodercli (Qoder CLI) als MCP-Tool verpackt, sodass jeder MCP-Client (Qoder IDE, Claude Code, Cursor usw.) Qoder wie einen Unter-Agenten aufrufen kann.

Warum / 为什么

Manche CLI-Agenten bieten einen offiziellen MCP-Server-Modus an (z. B. codex mcp-server), aber qodercli fungiert derzeit nur als MCP-Client. Dieses Projekt schließt diese Lücke mit einem dünnen Wrapper: Es startet qodercli -p <prompt> im Hintergrund und streamt das Ergebnis über MCP stdio zurück.

Einige CLI-Agenten bieten einen offiziellen MCP-Server-Modus (z. B. codex mcp-server), aber qodercli kann derzeit nur als MCP-Client agieren. Dieses Projekt füllt diese Lücke mit einer dünnen Wrapperschicht: Es ruft intern qodercli -p <prompt> auf und gibt das Ergebnis über MCP stdio zurück.

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

Funktionen / 功能

  • ask-qoder-Tool – delegiert eine Eingabeaufforderung an qodercli

  • ask-qoder-Tool – delegiert eine Aufgabe an qodercli

  • Strukturierte Ausgabe (session_id, is_error, duration_ms, total_credits, num_turns) über -o json-Parsing

  • Strukturierte Ausgabe (session_id, is_error, duration_ms, total_credits, num_turns), automatische Analyse von -o json

  • list-sessions-Tool zum Auffinden fortsetzbarer Sitzungen

  • list-sessions-Tool zum Auffinden fortsetzbarer Sitzungen

  • list-models-Tool zur Laufzeit-Modellerkennung (keine veralteten Modelllisten)

  • list-models-Tool zum Erkennen verfügbarer Modelle zur Laufzeit (keine veraltete Liste)

  • reasoning_effort-Parameter (--reasoning-effort)

  • reasoning_effort-Parameter (durchgereicht --reasoning-effort)

  • Server-instructions im MCP-Initialisierungsergebnis führen den Client zur Nutzung

  • MCP-Initialisierungsergebnis enthält Serveranweisungen, die den Client zur korrekten Nutzung führen

  • Codex-ähnliche sandbox-Stufen (read-only / workspace-write / danger-full-access)

  • Codex-ähnliche sandbox-Stufen (read-only / workspace-write / danger-full-access)

  • System-Prompt-Injektion (system_prompt / append_system_prompt)

  • System-Prompt-Injektion (system_prompt / append_system_prompt)

  • Arbeitsverzeichnis, Modell, Berechtigungsmodus, Ausgabeformatsteuerung

  • Unterstützt Arbeitsverzeichnis, Modell, Berechtigungsmodus, Ausgabeformat

  • Sitzungsfortsetzung (resume_session_id) für mehrstufige Delegation

  • Unterstützt Sitzungsfortsetzung (resume_session_id) für mehrstufige Delegation

  • Timeout-Schutz mit SIGKILL-Fallback

  • Timeout-Schutz (automatischer SIGKILL bei Timeout)

  • Proxy-Kontingentunterstützung (HTTP_PROXY / HTTPS_PROXY-Injektion)

  • Proxy-Kontingentunterstützung (HTTP_PROXY / HTTPS_PROXY-Injektion)

  • Kein Build-Schritt – reines ESM JavaScript, Node.js >= 18

  • Kein Build erforderlich – reines ESM JavaScript, Node.js >= 18

Voraussetzungen / 前置条件

  1. Node.js >= 18

  2. qodercli installiert und angemeldet (qodercli login)

Installation / 安装

Option A – npx (empfohlen / 推荐): kein Klonen erforderlich, der MCP-Client lädt das Paket bei der ersten Verwendung herunter. Kein Klonen erforderlich, der MCP-Client lädt das Paket bei der ersten Verwendung automatisch herunter:

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

Option B – aus dem Quellcode (für Entwicklung / 开发用):

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

MCP-Client-Konfiguration / MCP 客户端配置

Qoder IDE

Fügen Sie zu ~/.qoder/mcp.json hinzu. Bevorzugen Sie den absoluten Pfad von node und setzen Sie QODERCLI_PATH explizit (nvm-verwaltete Binärdateien fehlen oft im PATH, der von MCP-Kindprozessen gesehen wird):

Proxy-Unterstützung: Um Ihr Qoder-CLI-Proxy-Kontingent zu nutzen, fügen Sie HTTP_PROXY und/oder HTTPS_PROXY zur Umgebung des Servers hinzu. Wenn diese auf MCP-Serverebene gesetzt sind, werden sie an alle qodercli-Unterprozesse weitergegeben.

Fügen Sie zu ~/.qoder/mcp.json hinzu. Es wird empfohlen, den absoluten Pfad von node zu verwenden und QODERCLI_PATH explizit zu setzen (im PATH von MCP-Kindprozessen fehlen oft die von nvm verwalteten Binärdateien):

Proxy-Unterstützung: Um Ihr Qoder-CLI-Proxy-Kontingent zu nutzen, können Sie HTTP_PROXY und/oder HTTPS_PROXY in den Umgebungsvariablen des Servers hinzufügen. Wenn diese Variablen auf MCP-Serverebene gesetzt werden, werden sie an alle qodercli-Unterprozesse weitergegeben.

{
  "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"
      }
    }
  }
}

Entwickler, die einen lokalen Checkout anstelle des veröffentlichten Pakets verwenden (Option B), sollten command/args durch den absoluten node-Pfad und /path/to/qodercli-mcp/src/index.js ersetzen (nvm-verwaltetes node fehlt oft im PATH, der von MCP-Kindprozessen gesehen wird). Entwickler, die den lokalen Quellcode anstelle des veröffentlichten Pakets (Option B) verwenden, ersetzen bitte command/args durch den absoluten node-Pfad und /path/to/qodercli-mcp/src/index.js (im PATH der MCP-Kindprozesse fehlt oft das von nvm verwaltete node).

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

Typ

Beschreibung

prompt

string (erforderlich)

Die Aufgabe oder Frage für qodercli / 交给 qodercli 的任务或问题

cwd

string

Arbeitsverzeichnis / 工作目录

model

string

Modell für diese Sitzung; rufen Sie list-models auf, um verfügbare Namen zu ermitteln / 本次会话使用的模型,先用 list-models 查询

reasoning_effort

string

Reasoning-Effort-Stufe (--reasoning-effort), z. B. low/medium/high; hängt vom Modell ab / 推理强度,取决于模型

permission_mode

enum

dont_ask (Standard, schreibgeschützt) | accept_edits (Dateiänderungen automatisch genehmigen) | bypass_permissions (voller Zugriff inkl. Shell) | auto | default; schließt sich gegenseitig mit approval_policy aus, sandbox bevorzugen / 与 approval_policy 互斥,推荐用 sandbox

approval_policy

enum

codex-artig: untrusted→schreibgeschützt | on-request→auto | never→voller Zugriff / 仿 codex 审批策略,自动映射

sandbox

enum

read-only | workspace-write | danger-full-access (codex-artig; steuert den effektiven Berechtigungsmodus) / 控制实际权限级别

system_prompt

string

Standard-System-Prompt ersetzen / 替换默认系统提示

append_system_prompt

string

Anweisungen an den Standard-System-Prompt anhängen / 追加系统提示

resume_session_id

string

Vorherige Sitzung fortsetzen / 续接之前的会话

output_format

string

An -o übergeben (Standard json) / 透传给 -o(默认 json)。Hinweis: Nicht-JSON-Formate verschlechtern die strukturierte Ausgabe (session_id usw. werden nicht verfügbar) / 非 json 格式会使结构化字段失效

extra_args

string[]

Rohe CLI-Argumente, die vor dem Prompt angehängt werden; reservierte Flags (Berechtigungsmodus, System-Prompt, Modell, -o, -r, -w...) werden abgelehnt / 追加原始 CLI 参数;保留 flag 会被拒绝

timeout_ms

number

Timeout in ms, Standard 600000 / 超时毫秒数,默认 600000

Strukturierte Ausgabe / 结构化输出

ask-qoder deklariert ein MCP outputSchema und gibt zusätzlich zum menschenlesbaren Text ein structuredContent-Objekt zurück:

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

Effektiver Berechtigungsmodus / 实际权限模式

Auswirkung auf qodercli / 对 qodercli 的效果

(weggelassen / 缺省)

dont_ask

Schreibgeschützt: Berechtigungen erfordernde Tools werden stillschweigend abgelehnt / 只读:需授权的工具调用被静默拒绝

read-only

dont_ask

Zusätzlich --disallowed-tools write_file,replace,run_shell_command als Defense-in-Depth / 额外禁用写/shell 工具,双保险

workspace-write

accept_edits

Agent kann Dateien in cwd erstellen/ändern / 可在 cwd 创建/修改文件

danger-full-access

bypass_permissions

Voller Zugriff inklusive Shell / 完全权限(含 shell)

Explizites permission_mode oder approval_policy hat immer Vorrang vor sandbox. Explizit gesetztes permission_mode / approval_policy hat Vorrang vor sandbox.

Berechtigungsmodi (verifizierte Semantik) / 权限模式(实测语义)

Modus

Verhalten / 行为

dont_ask

Schreibgeschützt: lehnt jeden Tool-Aufruf, der eine Berechtigung erfordert, stillschweigend ab. Headless-sicherer Standard / 只读:静默拒绝一切需授权的工具调用;无头安全默认值

accept_edits

Dateiänderungen automatisch genehmigen; Shell weiterhin durch Richtlinie geregelt / 自动批准文件编辑

bypass_permissions

Alles automatisch genehmigen, einschließlich Shell / 全部自动批准(含 shell)

auto

qoderclis eigene automatische Richtlinie / qodercli 自动策略

default

Interaktive Bestätigung – nicht headless-freundlich, in MCP-Aufrufen vermeiden / 交互式确认,无头调用中应避免

Tool: list-sessions

Listet lokale qodercli-Sitzungen auf (Index, Zusammenfassung, Sitzungs-ID), sodass ein Client eine resume_session_id auswählen kann. Erwartet keine Argumente.

Listet lokale qodercli-Sitzungen auf (Index, Zusammenfassung, Sitzungs-ID), damit der Client eine resume_session_id auswählen kann. Keine Argumente.

Tool: list-models

Listet die derzeit von qodercli unterstützten Modelle auf (über --list-models), sodass ein Client zur Laufzeit einen gültigen model-Wert auswählen kann, anstatt sich auf veraltetes Wissen zu verlassen. Gibt sowohl eine Textliste als auch ein strukturiertes models-Array zurück. Erwartet keine Argumente.

Listet die derzeit von qodercli unterstützten Modelle auf, damit der Client zur Laufzeit einen gültigen model-Wert auswählen kann (ohne veraltetes Wissen). Gibt eine Textliste und ein strukturiertes models-Array zurück. Keine Argumente.

Anwendungsbeispiele / 使用示例

Beispiel 1: Einfache Code-Erklärung / 简单代码解释

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

Das Ergebnis liefert eine Erklärung in natürlicher Sprache, um das Verständnis der Dateifunktion zu unterstützen.

Das Ergebnis gibt eine natürliche Spracherklärung zurück, um das Verständnis der Dateifunktion zu unterstützen.

Beispiel 2: Zweite Meinung einholen / 获取第二意见

{ "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 gibt Sicherheitsempfehlungen und Verbesserungsvorschläge.

Qoder gibt Sicherheitsvorschläge und Verbesserungspläne.

Beispiel 3: Mehrstufige Konversation per Fortsetzung / 多轮对话续接

// 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": {} }

Durch resume_session_id können mehrstufige interaktive Iterationen zur Optimierung realisiert werden.

Über resume_session_id können mehrstufige interaktive iterative Optimierungen realisiert werden.

Beispiel 4: Code-Review mit spezifischem Fokus / 针对性代码审查

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

Geeignet für Szenarien der Leistungsanalyse und Optimierungsvorschläge.

Geeignet für Leistungsanalyse und Optimierungsvorschläge.

Beispiel 5: Schreibgeschützte Analyse / 只读分析

{ "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 deaktiviert Dateischreib- und Shell-Tools, geeignet für Audit-/Review-Szenarien.

read-only deaktiviert Dateischreib- und Shell-Tools, geeignet für Audit-/Review-Szenarien.

Beispiel 6: Projektweite Analyse / 项目范围分析

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

Geeignet für schnelle Erfassung und Architekturverständnis großer Projekte.

Geeignet für schnelle Erfassung und Architekturverständnis großer Projekte.

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",需要 shell 用 danger-full-access;勿与显式 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 代理地址

HTTPS_PROXY

-

HTTPS proxy URL for qodercli / qodercli 的 HTTPS 代理地址

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