coduck
Verified Safeby t3ta
Overview
Orchestrates Codex jobs in isolated Git worktrees, integrated with Claude Code via the Model Context Protocol (MCP) server for automated code generation, review, and deployment.
Installation
npm run mcpEnvironment Variables
- ORCHESTRATOR_PORT
- ORCHESTRATOR_URL
- WORKER_POLL_INTERVAL_MS
- WORKTREE_BASE_DIR
- CODEX_CLI_PATH
- GIT_PATH
- WORKER_CONCURRENCY
- CODEX_MCP_TIMEOUT_MS
- CODEX_REASONING_SUMMARY
- CODEX_REASONING_FORMAT
- ALLOWED_GIT_HOSTS
- ORCHESTRATOR_DB_PATH
- REPO_URL
Security Notes
The system uses `execFile`/`spawn` for Git and Codex CLI commands, which is inherently safer against shell injection than `exec`. A critical security measure, `validateRepoUrl`, mitigates SSRF by restricting external Git repository URLs to a configurable whitelist (GitHub and GitLab by default) and enforcing absolute local paths for 'no-worktree' mode. This protects the worker from fetching from malicious external URLs or making unintended requests to internal network services. No obvious hardcoded secrets, 'eval' calls, or code obfuscation were found. The 'no-worktree' mode, while intentional, allows the worker to operate directly on a specified absolute path (often `process.cwd()`), meaning a compromised orchestrator or an untrusted job creator could potentially cause unintended file system modifications outside of isolated worktrees. However, this is mitigated by validation on the `repo_url` for 'no-worktree' jobs (must be absolute path) and the design choice to not automatically clean up these directories.
Similar Servers
claude-flow
AI Agent Orchestration and Development Platform for Claude Code
claude-codex-settings
A comprehensive toolkit and configuration for developing Claude Code plugins, integrating various external services and APIs, and enhancing AI-assisted coding workflows.
consult-llm-mcp
An MCP server that allows AI agents like Claude Code to consult stronger, more capable AI models (e.g., GPT-5.2, Gemini 3.0 Pro) for complex code analysis, debugging, and architectural advice.
mcp-devtools-server
This MCP server standardizes development tool patterns and provides AI-powered integrations to enable Claude Code to generate code more efficiently, reduce errors, and improve autocorrection for various programming languages and workflows.