@zuens2020/back-agent-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ZUENS2020
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# 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

package/dist/claude/executor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Claude Code CLI Executor
+ *
+ * Executes tasks by spawning Claude Code as a child process.
+ */
+export interface ExecutionOptions {
+    /** Task description to execute */
+    task: string;
+    /** Working directory for Claude Code */
+    workingDirectory?: string;
+    /** Timeout in milliseconds (default: 300000 = 5 minutes) */
+    timeout?: number;
+    /** Additional CLI arguments for Claude Code */
+    additionalArgs?: string[];
+}
+export interface ExecutionResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    error?: string;
+}
+/**
+ * Execute a task using Claude Code CLI
+ */
+export declare function executeClaudeTask(options: ExecutionOptions): Promise<ExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/claude/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/claude/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkH3F"}

package/dist/claude/executor.js

@@ -0,0 +1,122 @@
+/**
+ * Claude Code CLI Executor
+ *
+ * Executes tasks by spawning Claude Code as a child process.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { ErrorCode, McpServerError } from '../utils/error-handler.js';
+/**
+ * Execute a task using Claude Code CLI
+ */
+export async function executeClaudeTask(options) {
+    const { task, workingDirectory, timeout = 300000, additionalArgs = [], } = options;
+    logger.info(`Executing task: "${task.substring(0, 100)}${task.length > 100 ? '...' : ''}"`);
+    // Validate working directory if provided
+    let cwd;
+    if (workingDirectory) {
+        cwd = resolve(workingDirectory);
+        if (!existsSync(cwd)) {
+            throw new McpServerError(ErrorCode.INVALID_WORKING_DIRECTORY, `Working directory does not exist: ${workingDirectory}`, { path: cwd });
+        }
+        logger.info(`Using working directory: ${cwd}`);
+    }
+    // Build CLI arguments
+    const args = buildCliArgs(task, cwd, additionalArgs);
+    logger.debug(`Claude CLI args: ${JSON.stringify(args)}`);
+    // Spawn the process
+    const claude = spawn('claude', args, {
+        env: process.env,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: true, // Use shell to find 'claude' in PATH
+    });
+    let stdout = '';
+    let stderr = '';
+    let timedOut = false;
+    // Set timeout
+    const timeoutHandle = setTimeout(() => {
+        logger.warn(`Task timeout after ${timeout}ms, terminating process...`);
+        timedOut = true;
+        claude.kill('SIGTERM');
+    }, timeout);
+    // Collect stdout
+    claude.stdout?.on('data', (data) => {
+        const chunk = data.toString();
+        stdout += chunk;
+        logger.debug(`stdout: ${chunk.substring(0, 200)}`);
+    });
+    // Collect stderr
+    claude.stderr?.on('data', (data) => {
+        const chunk = data.toString();
+        stderr += chunk;
+        logger.debug(`stderr: ${chunk.substring(0, 200)}`);
+    });
+    // Wait for process to exit
+    return new Promise((resolve) => {
+        claude.on('close', (code) => {
+            clearTimeout(timeoutHandle);
+            if (timedOut) {
+                logger.error('Task execution timed out');
+                resolve({
+                    success: false,
+                    stdout,
+                    stderr,
+                    exitCode: code,
+                    error: `Execution timed out after ${timeout}ms`,
+                });
+                return;
+            }
+            const success = code === 0;
+            logger.info(`Task completed with exit code: ${code}`);
+            resolve({
+                success,
+                stdout,
+                stderr,
+                exitCode: code,
+            });
+        });
+        claude.on('error', (error) => {
+            clearTimeout(timeoutHandle);
+            // Check if Claude Code is not found
+            if (error.message.includes('ENOENT') || error.message.includes('not found')) {
+                logger.error('Claude Code CLI not found');
+                resolve({
+                    success: false,
+                    stdout: '',
+                    stderr: '',
+                    exitCode: null,
+                    error: 'Claude Code CLI not found. Please ensure Claude Code is installed and in your PATH.',
+                });
+                return;
+            }
+            logger.error(`Process error: ${error.message}`);
+            resolve({
+                success: false,
+                stdout,
+                stderr,
+                exitCode: null,
+                error: error.message,
+            });
+        });
+    });
+}
+/**
+ * Build CLI arguments for Claude Code
+ */
+function buildCliArgs(task, workingDirectory, additionalArgs = []) {
+    const args = [];
+    // Add working directory if specified
+    if (workingDirectory) {
+        args.push('--directory', workingDirectory);
+    }
+    // Add additional arguments (exclude -p if user provided it, we add it by default)
+    const filteredArgs = additionalArgs.filter(arg => arg !== '-p' && arg !== '--print');
+    args.push(...filteredArgs);
+    // Add -p flag for one-time execution (non-interactive mode)
+    // This must come immediately before the task
+    args.push('-p', task);
+    return args;
+}
+//# sourceMappingURL=executor.js.map

package/dist/claude/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/claude/executor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Back-Agent MCP Server
+ *
+ * An MCP server that executes tasks using Claude Code CLI.
+ *
+ * Main entry point for the server.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,59 @@
+/**
+ * Back-Agent MCP Server
+ *
+ * An MCP server that executes tasks using Claude Code CLI.
+ *
+ * Main entry point for the server.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerExecuteTaskTool } from './server/tools/execute-task.js';
+import { logger, setLogLevel, LogLevel } from './utils/logger.js';
+const SERVER_INFO = {
+    name: 'back-agent-mcp',
+    version: '1.0.0',
+};
+/**
+ * Start the MCP server
+ */
+async function main() {
+    // Set log level from environment variable if provided
+    const logLevel = process.env.LOG_LEVEL?.toUpperCase();
+    if (logLevel === 'DEBUG') {
+        setLogLevel(LogLevel.DEBUG);
+    }
+    else if (logLevel === 'WARN') {
+        setLogLevel(LogLevel.WARN);
+    }
+    else if (logLevel === 'ERROR') {
+        setLogLevel(LogLevel.ERROR);
+    }
+    logger.info(`Starting ${SERVER_INFO.name} v${SERVER_INFO.version}`);
+    // Create MCP server instance
+    const server = new McpServer(SERVER_INFO);
+    // Register tools
+    registerExecuteTaskTool(server);
+    logger.info('Registered tool: execute-task');
+    // Create stdio transport for communication
+    const transport = new StdioServerTransport();
+    // Connect the server to the transport
+    await server.connect(transport);
+    // IMPORTANT: Log to stderr, not stdout (stdio is used for MCP communication)
+    logger.info('Back-Agent MCP Server is running');
+    logger.info('Waiting for tool calls...');
+}
+// Start the server
+main().catch((error) => {
+    logger.error(`Fatal error starting server: ${error}`);
+    process.exit(1);
+});
+// Handle graceful shutdown
+process.on('SIGINT', () => {
+    logger.info('Received SIGINT, shutting down...');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    logger.info('Received SIGTERM, shutting down...');
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,sDAAsD;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;IACtD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;SAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,YAAY,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpE,6BAA6B;IAC7B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IAE1C,iBAAiB;IACjB,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAE7C,2CAA2C;IAC3C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,sCAAsC;IACtC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,6EAA6E;IAC7E,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;AAC3C,CAAC;AAED,mBAAmB;AACnB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,2BAA2B;AAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server/tools/execute-task.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Execute Task Tool for MCP Server
+ *
+ * This tool allows clients to execute development tasks using Claude Code CLI.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+/**
+ * Input schema for the execute-task tool
+ */
+export declare const executeTaskInputSchema: z.ZodObject<{
+    task: z.ZodString;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    additionalArgs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    task: string;
+    workingDirectory?: string | undefined;
+    timeout?: number | undefined;
+    additionalArgs?: string[] | undefined;
+}, {
+    task: string;
+    workingDirectory?: string | undefined;
+    timeout?: number | undefined;
+    additionalArgs?: string[] | undefined;
+}>;
+export type ExecuteTaskInput = z.infer<typeof executeTaskInputSchema>;
+/**
+ * Register the execute-task tool with the MCP server
+ */
+export declare function registerExecuteTaskTool(server: McpServer): void;
+//# sourceMappingURL=execute-task.d.ts.map

package/dist/server/tools/execute-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-task.d.ts","sourceRoot":"","sources":["../../../src/server/tools/execute-task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqE/D"}

package/dist/server/tools/execute-task.js

@@ -0,0 +1,127 @@
+/**
+ * Execute Task Tool for MCP Server
+ *
+ * This tool allows clients to execute development tasks using Claude Code CLI.
+ */
+import { z } from 'zod';
+import { executeClaudeTask } from '../../claude/executor.js';
+import { logger } from '../../utils/logger.js';
+import { createErrorResponse } from '../../utils/error-handler.js';
+/**
+ * Input schema for the execute-task tool
+ */
+export const executeTaskInputSchema = z.object({
+    task: z.string().describe('The task description to execute with Claude Code'),
+    workingDirectory: z.string().optional().describe('The working directory for Claude Code execution'),
+    timeout: z.number().min(1).max(3600).optional().describe('Timeout in seconds (max 3600)'),
+    additionalArgs: z.array(z.string()).optional().describe('Additional CLI arguments for Claude Code'),
+});
+/**
+ * Register the execute-task tool with the MCP server
+ */
+export function registerExecuteTaskTool(server) {
+    server.registerTool('execute-task', {
+        description: 'Execute a development task using Claude Code CLI. ' +
+            'This tool spawns Claude Code as a child process and returns the output. ' +
+            'Useful for automated code generation, refactoring, debugging, and other development tasks.',
+        inputSchema: executeTaskInputSchema,
+    }, async (input) => {
+        // Validate input
+        const validationResult = executeTaskInputSchema.safeParse(input);
+        if (!validationResult.success) {
+            const errorMessages = validationResult.error.errors
+                .map((e) => `${e.path.join('.')}: ${e.message}`)
+                .join(', ');
+            logger.error(`Invalid input: ${errorMessages}`);
+            return createErrorResponse(new Error(`Invalid input: ${errorMessages}`));
+        }
+        const { task, workingDirectory, timeout = 300, additionalArgs = [] } = validationResult.data;
+        logger.info(`Executing task via MCP: "${task.substring(0, 50)}..."`);
+        try {
+            // Execute the task
+            const result = await executeClaudeTask({
+                task,
+                workingDirectory,
+                timeout: timeout * 1000, // Convert to milliseconds
+                additionalArgs,
+            });
+            // Format and return the result
+            if (result.success) {
+                const output = result.stdout.trim()
+                    ? result.stdout
+                    : 'Task completed successfully with no output.';
+                logger.info('Task completed successfully');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: formatSuccessOutput(output, result.exitCode),
+                        },
+                    ],
+                };
+            }
+            else {
+                logger.error('Task execution failed');
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: formatErrorOutput(result, task),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        catch (error) {
+            logger.error(`Unexpected error: ${error}`);
+            return createErrorResponse(error);
+        }
+    });
+}
+/**
+ * Format successful execution output
+ */
+function formatSuccessOutput(stdout, exitCode) {
+    const lines = [];
+    lines.push('## Task Completed Successfully');
+    lines.push('');
+    if (stdout) {
+        lines.push('### Output:');
+        lines.push('```\n' + stdout.trim() + '\n```');
+    }
+    if (exitCode !== null) {
+        lines.push('');
+        lines.push(`Exit Code: ${exitCode}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Format failed execution output
+ */
+function formatErrorOutput(result, task) {
+    const lines = [];
+    lines.push('## Task Execution Failed');
+    lines.push('');
+    lines.push(`**Task:** ${task.substring(0, 100)}${task.length > 100 ? '...' : ''}`);
+    lines.push('');
+    if (result.error) {
+        lines.push(`**Error:** ${result.error}`);
+        lines.push('');
+    }
+    if (result.stderr) {
+        lines.push('### Error Output:');
+        lines.push('```\n' + result.stderr.trim() + '\n```');
+        lines.push('');
+    }
+    if (result.stdout) {
+        lines.push('### Standard Output:');
+        lines.push('```\n' + result.stdout.trim() + '\n```');
+        lines.push('');
+    }
+    if (result.exitCode !== null) {
+        lines.push(`Exit Code: ${result.exitCode}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=execute-task.js.map

package/dist/server/tools/execute-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-task.js","sourceRoot":"","sources":["../../../src/server/tools/execute-task.ts"],"names":[],"mappings":"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"}

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Error types and error handling utilities for Back-Agent MCP Server
+ */
+export declare enum ErrorCode {
+    CLAUDE_NOT_FOUND = "CLAUDE_NOT_FOUND",
+    INVALID_WORKING_DIRECTORY = "INVALID_WORKING_DIRECTORY",
+    EXECUTION_TIMEOUT = "EXECUTION_TIMEOUT",
+    EXECUTION_FAILED = "EXECUTION_FAILED",
+    INVALID_INPUT = "INVALID_INPUT",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+export declare class McpServerError extends Error {
+    code: ErrorCode;
+    details?: unknown | undefined;
+    constructor(code: ErrorCode, message: string, details?: unknown | undefined);
+}
+export declare function isMcpServerError(error: unknown): error is McpServerError;
+export declare function formatErrorMessage(error: unknown): string;
+/**
+ * Create a standardized error response for MCP tool calls
+ */
+export declare function createErrorResponse(error: unknown): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,gBAAgB,qBAAqB;IACrC,yBAAyB,8BAA8B;IACvD,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CAClC;AAED,qBAAa,cAAe,SAAQ,KAAK;IAE9B,IAAI,EAAE,SAAS;IAEf,OAAO,CAAC,EAAE,OAAO;gBAFjB,IAAI,EAAE,SAAS,EACtB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAczD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf,CAMA"}

package/dist/utils/error-handler.js

@@ -0,0 +1,49 @@
+/**
+ * Error types and error handling utilities for Back-Agent MCP Server
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["CLAUDE_NOT_FOUND"] = "CLAUDE_NOT_FOUND";
+    ErrorCode["INVALID_WORKING_DIRECTORY"] = "INVALID_WORKING_DIRECTORY";
+    ErrorCode["EXECUTION_TIMEOUT"] = "EXECUTION_TIMEOUT";
+    ErrorCode["EXECUTION_FAILED"] = "EXECUTION_FAILED";
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class McpServerError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'McpServerError';
+    }
+}
+export function isMcpServerError(error) {
+    return error instanceof McpServerError;
+}
+export function formatErrorMessage(error) {
+    if (isMcpServerError(error)) {
+        let message = `[${error.code}] ${error.message}`;
+        if (error.details) {
+            message += `\nDetails: ${JSON.stringify(error.details)}`;
+        }
+        return message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Create a standardized error response for MCP tool calls
+ */
+export function createErrorResponse(error) {
+    const message = formatErrorMessage(error);
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,kDAAqC,CAAA;IACrC,oEAAuD,CAAA;IACvD,oDAAuC,CAAA;IACvC,kDAAqC,CAAA;IACrC,4CAA+B,CAAA;IAC/B,8CAAiC,CAAA;AACnC,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAE9B;IAEA;IAHT,YACS,IAAe,EACtB,OAAe,EACR,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAW;QAEf,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAI,OAAO,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,IAAI,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAIhD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Logger utility for Back-Agent MCP Server
+ *
+ * IMPORTANT: All logs must go to stderr to avoid interfering with
+ * the MCP stdio communication (which uses stdout for JSON-RPC messages).
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+/**
+ * Set the current log level
+ */
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAID;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AA6BD,eAAO,MAAM,MAAM;qBACA,MAAM,WAAW,OAAO,EAAE;oBAC3B,MAAM,WAAW,OAAO,EAAE;oBAC1B,MAAM,WAAW,OAAO,EAAE;qBACzB,MAAM,WAAW,OAAO,EAAE;CAC5C,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,49 @@
+/**
+ * Logger utility for Back-Agent MCP Server
+ *
+ * IMPORTANT: All logs must go to stderr to avoid interfering with
+ * the MCP stdio communication (which uses stdout for JSON-RPC messages).
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+let currentLogLevel = LogLevel.INFO;
+/**
+ * Set the current log level
+ */
+export function setLogLevel(level) {
+    currentLogLevel = level;
+}
+/**
+ * Format timestamp for log messages
+ */
+function getTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Write log message to stderr
+ */
+function log(level, message, ...args) {
+    if (level < currentLogLevel) {
+        return;
+    }
+    const levelName = LogLevel[level];
+    const timestamp = getTimestamp();
+    const prefix = `[${timestamp}] [${levelName}]`;
+    const output = args.length > 0
+        ? `${prefix} ${message} ${args.map(String).join(' ')}`
+        : `${prefix} ${message}`;
+    // Always write to stderr to avoid interfering with MCP stdio communication
+    console.error(output);
+}
+export const logger = {
+    debug: (message, ...args) => log(LogLevel.DEBUG, message, ...args),
+    info: (message, ...args) => log(LogLevel.INFO, message, ...args),
+    warn: (message, ...args) => log(LogLevel.WARN, message, ...args),
+    error: (message, ...args) => log(LogLevel.ERROR, message, ...args),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED,IAAI,eAAe,GAAa,QAAQ,CAAC,IAAI,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,eAAe,GAAG,KAAK,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,YAAY;IACnB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,GAAG,IAAe;IAC/D,IAAI,KAAK,GAAG,eAAe,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,SAAS,GAAG,CAAC;IAE/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACtD,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAE3B,2EAA2E;IAC3E,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACrF,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACnF,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACnF,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACtF,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@zuens2020/back-agent-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for executing tasks via Claude Code CLI",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "back-agent-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "automation",
+    "claude",
+    "ai"
+  ],
+  "author": "ZUENS2020 <shengyuanzhang-zuens2020@outlook.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZUENS2020/back-agent-mcp.git"
+  },
+  "homepage": "https://github.com/ZUENS2020/back-agent-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/ZUENS2020/back-agent-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}