MCP server for executing tasks via Claude Code CLI
npm install @zuens2020/back-agent-mcpAn MCP (Model Context Protocol) server that executes development tasks using Claude Code CLI.
- Execute tasks through Claude Code CLI via MCP protocol
- Non-interactive mode by default (-p flag auto-applied)
- Specify custom working directories
- Configurable timeout settings
- Comprehensive error handling and logging
- Node.js >= 18
- Claude Code CLI installed and available in PATH
``bashClone the repository
git clone
cd back-agent-mcp
Usage
$3
`bash
Development mode (with tsx)
npm run devProduction mode (built)
npm start
`$3
`bash
npm install @zuens2020/back-agent-mcp
`$3
Add the following to your Claude Desktop configuration file:
Windows:
%APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json`json
{
"mcpServers": {
"back-agent": {
"command": "node",
"args": ["--experimental-modules", "C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@zuens2020\\back-agent-mcp\\dist\\index.js"]
}
}
}
`Or using npx:
`json
{
"mcpServers": {
"back-agent": {
"command": "npx",
"args": ["-y", "@zuens2020/back-agent-mcp"]
}
}
}
`$3
#### execute-task
Executes a development task using Claude Code CLI.
Parameters:
| Name | Type | Required | Description |
|------|------|----------|-------------|
|
task | string | Yes | The task description to execute |
| workingDirectory | string | No | Working directory for execution |
| timeout | number | No | Timeout in seconds (max 3600, default 300) |
| additionalArgs | string[] | No | Additional CLI arguments (excluding -p which is auto-added) |Example:
`json
{
"task": "Create a function that calculates fibonacci numbers",
"workingDirectory": "C:\\Projects\\my-app",
"timeout": 600
}
`Development
`bash
Type checking
npm run typecheckBuild
npm run buildDevelopment mode
npm run dev
`Project Structure
`
src/
├── index.ts # Main entry point
├── server/
│ └── tools/
│ └── execute-task.ts # Task execution tool
├── claude/
│ └── executor.ts # Claude Code CLI executor
└── utils/
├── logger.ts # Logging utilities
└── error-handler.ts # Error handling
`Environment Variables
| Variable | Description | Values |
|----------|-------------|--------|
|
LOG_LEVEL | Set logging verbosity | DEBUG, INFO, WARN, ERROR` |MIT