# Back-Agent MCP Server
An MCP (Model Context Protocol) server that executes development tasks using Claude Code CLI.
## Features
- 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
## Prerequisites
- Node.js >= 18
- Claude Code CLI installed and available in PATH
## Installation
```bash
# Clone the repository
git clone <repository-url>
cd back-agent-mcp
# Install dependencies
npm install
# Build the project
npm run build
```
## Usage
### Running the Server
```bash
# Development mode (with tsx)
npm run dev
# Production mode (built)
npm start
```
### Installation
```bash
npm install @zuens2020/back-agent-mcp
```
### Configuration with Claude Desktop
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"]
}
}
}
```
### Available Tools
#### 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 typecheck
# Build
npm run build
# Development 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` |
## License
MIT
