Claude Code 또는 Cursor와 같은 MCP 클라이언트에서 로컬 Qoder agent에게 코딩 작업을 위임합니다.
다른 이름 cantbeblank96/qodercli-mcp
- 스타
- 0
- Tools
- 21
- 다운로드, 30일
- —
- 최신 버전
- 0.4.3
- 마지막 커밋
- 2026년 8월 20일
- 라이선스
- MIT
qodercli MCP란?
Claude Code 또는 Cursor와 같은 MCP 클라이언트에서 로컬 Qoder agent에게 코딩 작업을 위임합니다. 21개 도구를 제공합니다. 예: prompt, cwd, model.
프로젝트 README에서 생성된 요약
qodercli MCP server 정보
이 server는 Claude Code, Cursor 또는 Qoder IDE와 같은 MCP 클라이언트 내에서 로컬 Qoder agent에게 코딩 작업을 위임할 수 있게 해줍니다. qodercli CLI의 얇은 래퍼(wrapper) 역할을 수행하며, 호환되는 모든 클라이언트가 복잡한 프로그래밍 작업을 위한 서브 에이전트로 Qoder를 사용할 수 있도록 지원합니다. 사용자는 프롬프트 실행을 위한 ask-qoder, 이전 작업 확인을 위한 list-sessions, 런타임 시 사용 가능한 AI 모델 확인을 위한 list-models 등 세 가지 주요 도구를 통해 작업을 관리할 수 있습니다.
설정은 npx를 사용하여 간편하게 진행할 수 있으며, Node.js와 로컬 머신에 로그인된 qodercli 설치만 필요합니다. 이 server는 read-only, workspace-write, danger-full-access와 같은 샌드박스 레벨을 통해 보안에 대한 세밀한 제어를 제공합니다. 또한 session ID, 소요 시간, 크레딧 사용량을 포함하는 구조화된 JSON 출력을 지원하여 특정 세션을 재개함으로써 멀티턴 대화를 가능하게 합니다. 개발자는 프록시 지원을 위해 환경 변수를 구성하거나, 선호하는 개발 환경 내에서 안정적인 실행을 보장하기 위해 qodercli 바이너리의 사용자 정의 경로를 지정할 수 있습니다.
활용 사례
- 1멀티턴 리팩터링 수행개발자가 리팩터링을 시작한 후, 세션 ID를 사용하여 새로운 턴에서 후속 지침을 전달할 수 있습니다.
- 2안전한 코드 감사 수행에이전트가 파일을 수정할 수 없도록 제한하면서 코드베이스에 대한 보안 검토를 요청할 수 있습니다.
- 3사용 가능한 AI 모델 확인AI 클라이언트가 CLI에서 현재 지원하는 모델을 확인하여 오래된 모델 이름을 사용하는 것을 방지할 수 있습니다.
- 4파일 수정 자동화사용자가 특정 작업 디렉토리 내에서 에이전트가 파일을 자동으로 생성하거나 편집할 수 있는 권한을 부여할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
qodercli MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 qodercli MCP 설치
$ claude mcp add qodercli-mcp -- npx -y qodercli-mcpCursor에 qodercli MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"qodercli-mcp": {
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}VS Code에 qodercli MCP 설치
.vscode/mcp.json
{
"servers": {
"qodercli-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}VS Code CLI에 qodercli MCP 설치
$ code --add-mcp '{"name":"qodercli-mcp","type":"stdio","command":"npx","args":["-y","qodercli-mcp"]}'Claude Desktop에 qodercli MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"qodercli-mcp": {
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}Codex에 qodercli MCP 설치
$ codex mcp add qodercli-mcp -- npx -y qodercli-mcpCodex config.toml에 qodercli MCP 설치
~/.codex/config.toml
[mcp_servers.qodercli-mcp] command = "npx" args = ["-y", "qodercli-mcp"]
Gemini CLI에 qodercli MCP 설치
$ gemini mcp add -s user qodercli-mcp npx -- -y qodercli-mcpGemini settings.json에 qodercli MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"qodercli-mcp": {
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}qodercli MCP 도구 21
README에서 감지됨promptcwdmodelreasoning_effortpermission_modeapproval_policysandboxsystem_promptappend_system_promptresume_session_idoutput_formatextra_args
| prompt | — | |
| cwd | — | |
| model | — | |
| reasoning_effort | — | |
| permission_mode | — | |
| approval_policy | — | |
| sandbox | — | |
| system_prompt | — | |
| append_system_prompt | — | |
| resume_session_id | — | |
| output_format | — | |
| extra_args | — |
도구 21개 모두 보기도구 수 줄이기
timeout_msread-onlyworkspace-writedanger-full-accessdont_askaccept_editsbypass_permissionsautodefault
| timeout_ms | — | |
| read-only | — | |
| workspace-write | — | |
| danger-full-access | — | |
| dont_ask | — | |
| accept_edits | — | |
| bypass_permissions | — | |
| auto | — | |
| default | — |
구성
HTTPS_PROXYHTTPS proxy injected into qodercli subprocesses (optional)
HTTP_PROXYHTTP proxy injected into qodercli subprocesses (optional)
QODERCLI_DEFAULT_PERMISSION_MODEDefault permission mode when callers omit permission params: dont_ask (default, read-only) | accept_edits | bypass_permissions | auto | default
QODERCLI_PATHAbsolute path to the qodercli binary (defaults to `qodercli` on PATH)
| 이름 | 설명 | 유형 |
|---|---|---|
| HTTPS_PROXY | HTTPS proxy injected into qodercli subprocesses (optional) | |
| HTTP_PROXY | HTTP proxy injected into qodercli subprocesses (optional) | |
| QODERCLI_DEFAULT_PERMISSION_MODE | Default permission mode when callers omit permission params: dont_ask (default, read-only) | accept_edits | bypass_permissions | auto | default | |
| QODERCLI_PATH | Absolute path to the qodercli binary (defaults to `qodercli` on PATH) |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능cantbeblank96/qodercli-mcp is public and reachablegithub.com/cantbeblank96/qodercli-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시qodercli-mcp names cantbeblank96/qodercli-mcp as sourcenpmjs.com/package/qodercli-mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-08-20github.com/cantbeblank96/qodercli-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from qodercli-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음99 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음21 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기qodercli-mcp
English | 简体中文
The missing MCP server mode for Qoder CLI — delegate coding tasks to local Qoder agents from any MCP client (Qoder IDE, Claude Code, Cursor…).
A minimal MCP server that wraps the local qodercli (Qoder CLI) as MCP tools, letting any MCP client (Qoder IDE, Claude Code, Cursor, …) call Qoder like a sub-agent.

30s demo: MCP client ⇄ qodercli-mcp ⇄ qodercli — initialize → tools/list → list-models (real output, not sped up)
Quick start
Zero-config via npx — add this to your MCP client config (~/.qoder/mcp.json, claude_desktop_config.json, …):
{ "mcpServers": { "qodercli-mcp": { "command": "npx", "args": ["-y", "qodercli-mcp"] } } }
Three tools are exposed:
| Tool | Purpose |
|---|---|
ask-qoder |
Delegate a task to qodercli |
list-sessions |
Discover resumable sessions |
list-models |
Runtime model discovery |
Highlights: verified permission semantics (see below — e.g. dont_ask is read-only),
codex-style sandbox/approval_policy, structured output (session_id/duration_ms/total_credits).
Full configuration options are in Install.
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.
Features
ask-qodertool — delegate a prompt to qodercli- Structured output (
session_id,is_error,duration_ms,total_credits,num_turns) via-o jsonparsing list-sessionstool to discover resumable sessionslist-modelstool for runtime model discovery (no stale model lists)reasoning_effortparameter (--reasoning-effort)- Server
instructionsin the MCP initialize result guide clients on usage - Codex-style
sandboxlevels (read-only/workspace-write/danger-full-access) - System prompt injection (
system_prompt/append_system_prompt) - Working directory, model, permission mode, output format control
- Session resume (
resume_session_id) for multi-turn delegation - Timeout protection with SIGKILL fallback
- Proxy quota support (
HTTP_PROXY/HTTPS_PROXYinjection) - Zero build step — plain ESM JavaScript, Node.js >= 18
Prerequisites
- Node.js >= 18
qodercliinstalled and signed in (qodercli login)
Install
Option A — npx (recommended): no clone needed, the MCP client downloads the package on first use.
"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
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_PROXYand/orHTTPS_PROXYto the server's environment. When these are set at the MCP server level, they will be passed to all qodercli subprocesses.
{
"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).
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 |
cwd |
string | Working directory |
model |
string | Model for this session; call list-models to discover available names |
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 |
enum | codex-style: untrusted→read-only | on-request→auto | never→full access |
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). Note: non-json formats degrade structured output (session_id etc. become unavailable) |
extra_args |
string[] | Raw CLI args appended before the prompt; reserved flags (permission mode, system prompt, model, -o, -r, -w...) are rejected |
timeout_ms |
number | Timeout in ms, default 600000 |
Structured output
ask-qoder declares an MCP outputSchema and returns, in addition to the
human-readable text, a structuredContent object:
{
"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 |
|---|---|---|
| (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 |
workspace-write |
accept_edits |
Agent can create/modify files in cwd |
danger-full-access |
bypass_permissions |
Full access including shell |
Explicit permission_mode or approval_policy always wins over 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 |
default |
Interactive confirmation — not headless-friendly, avoid in MCP calls |
Tool: list-sessions
Lists local qodercli sessions (index, summary, session id) so a client can
pick a resume_session_id. Takes no arguments.
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.
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
}}
Example 3: Multi-turn conversation via resume
// First call — session_id comes back in 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:
{ "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
{ "name": "list-sessions", "arguments": {} }
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 disables write/shell tools — good for audits and reviews.
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
- Specify working directory — Always pass
cwdwhen operating on a specific project - Use timeout protection — For complex prompts, set explicit
timeout_msshorter than 60min - Resume for multi-turn — Chain follow-ups via
resume_session_idinstead of repeating context - Model selection — Call
list-modelsfirst to discover currently supported models; larger models are better for deep analysis - Permission mode — The server default is read-only (
dont_ask); setQODERCLI_DEFAULT_PERMISSION_MODE=bypass_permissionsto make full (YOLO) access the default for personal deployments. Per-call: tasks that must create/modify files needsandbox: "workspace-write"; shell access needsdanger-full-access. Do not combinesandboxwith an explicitpermission_mode(the latter wins)
Environment variables
| Variable | Default | Description |
|---|---|---|
QODERCLI_PATH |
qodercli |
Path to the qodercli binary |
QODERCLI_TIMEOUT_MS |
600000 |
Default timeout |
QODERCLI_MAX_OUTPUT_MB |
50 |
Per-call stdout/stderr cap in MB (OOM protection) |
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 |
HTTP_PROXY |
- | HTTP proxy URL for qodercli |
HTTPS_PROXY |
- | HTTPS proxy URL for qodercli |
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.
Product Hunt Gallery
Main gallery image (1270×760, dark tech theme): ph-gallery.png. Optional demo video can be converted from the GIF (docs/demo.gif).
License
MIT
qodercli MCP 질문
qodercli MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add qodercli-mcp -- npx -y qodercli-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
qodercli MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
qodercli MCP는 어떤 도구를 제공하나요?
21개 도구를 제공합니다. 예: prompt, cwd, model, reasoning_effort, permission_mode.
이 MCP server는 어떤 도구를 제공하나요?
작업 위임을 위한 ask-qoder, 재개 가능한 세션을 확인하는 list-sessions, 런타임 모델 확인을 위한 list-models 등 세 가지 도구를 제공합니다.
qodercli-mcp에서 프록시를 어떻게 사용하나요?
서버 환경 변수에 HTTP_PROXY 및/또는 HTTPS_PROXY를 추가하여 Qoder CLI 프록시 쿼터를 사용할 수 있습니다.
이전 코딩 세션을 재개할 수 있나요?
네, 이전 작업에서 반환된 session_id를 새로운 호출의 resume_session_id로 사용하면 멀티턴 위임이 가능합니다.
빌드 단계 없이 실행할 수 있는 방법이 있나요?
네, 별도의 빌드 과정 없이 npx를 통해 바로 실행할 수 있는 순수 ESM JavaScript 패키지입니다.