Делегируйте задачи по написанию кода локальным агентам Qoder из любого MCP-клиента, такого как Claude Code или Cursor.
Также известен как cantbeblank96/qodercli-mcp
- Звёзды
- 0
- Инструменты
- 21
- Загрузки, 30 дней
- —
- Последняя версия
- 0.4.3
- Последний коммит
- 20 авг. 2026 г.
- Лицензия
- MIT
Что такое qodercli MCP?
Делегируйте задачи по написанию кода локальным агентам Qoder из любого MCP-клиента, такого как Claude Code или Cursor. Он предоставляет 21 инструмент, например prompt, cwd, model.
Сводка сгенерирована из README проекта
О qodercli MCP server
Этот сервер позволяет делегировать задачи по написанию кода локальным агентам Qoder прямо из MCP-клиентов, таких как Claude Code, Cursor или Qoder IDE. Он выступает в роли тонкой обертки над интерфейсом командной строки qodercli, позволяя любому совместимому клиенту использовать Qoder в качестве субагента для выполнения сложных задач программирования. Пользователи могут управлять задачами с помощью трех основных инструментов: ask-qoder для выполнения промптов, list-sessions для поиска результатов предыдущей работы и list-models для обнаружения доступных AI-моделей во время выполнения.
Настройка выполняется просто через npx и требует только наличия Node.js и установленного и авторизованного qodercli на вашем локальном компьютере. Сервер обеспечивает детальный контроль безопасности через уровни песочницы, такие как read-only, workspace-write и danger-full-access. Он также поддерживает структурированный вывод JSON, содержащий session ID, длительность и расход кредитов, что позволяет вести многошаговые диалоги путем возобновления конкретных сессий. Разработчики могут настроить переменные окружения для поддержки прокси или указать пользовательские пути к бинарному файлу qodercli, чтобы обеспечить надежную работу в предпочитаемой среде разработки.
Что вы можете с ним делать
- 1Выполнение многошагового рефакторингаРазработчик может инициировать рефакторинг, а затем использовать session ID, чтобы передать последующие инструкции в новом цикле.
- 2Проведение безопасного аудита кодаВы можете запросить проверку безопасности кодовой базы, гарантируя при этом, что агент не сможет изменить никакие файлы.
- 3Обнаружение доступных AI-моделейAI-клиент может проверить, какие модели в данный момент поддерживаются CLI, чтобы избежать использования устаревших названий.
- 4Автоматизация изменений в файлахПользователи могут предоставить агенту разрешение на автоматическое создание или редактирование файлов в определенной рабочей директории.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить qodercli MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка qodercli MCP в Claude Code
$ claude mcp add qodercli-mcp -- npx -y qodercli-mcpУстановка qodercli MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"qodercli-mcp": {
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}Установка qodercli MCP в VS Code
.vscode/mcp.json
{
"servers": {
"qodercli-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}Установка qodercli MCP в VS Code CLI
$ code --add-mcp '{"name":"qodercli-mcp","type":"stdio","command":"npx","args":["-y","qodercli-mcp"]}'Установка qodercli MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"qodercli-mcp": {
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}Установка qodercli MCP в Codex
$ codex mcp add qodercli-mcp -- npx -y qodercli-mcpУстановка qodercli MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.qodercli-mcp] command = "npx" args = ["-y", "qodercli-mcp"]
Установка qodercli MCP в Gemini CLI
$ gemini mcp add -s user qodercli-mcp npx -- -y qodercli-mcpУстановка qodercli MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"qodercli-mcp": {
"command": "npx",
"args": [
"-y",
"qodercli-mcp"
]
}
}
}Инструменты qodercli MCP 21
Определено из READMEpromptcwdmodelreasoning_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) |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторий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Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний год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
Открыть на GitHubqodercli-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?
Вы можете использовать свою квоту прокси Qoder CLI, добавив HTTP_PROXY и/или HTTPS_PROXY в переменные окружения сервера.
Могу ли я возобновить предыдущую сессию программирования?
Да, вы можете использовать session_id, полученный в результате предыдущей задачи, в качестве resume_session_id в новом вызове, чтобы обеспечить многошаговое делегирование.
Можно ли запустить это без этапа сборки?
Да, это обычный ESM JavaScript пакет, который можно запустить через npx без каких-либо этапов сборки.