initialize_code_file

Create a new Python file with initial content to start coding projects that may exceed token limits, enabling structured code execution in Conda environments.

Instructions

Create a new Python file with initial content. Use this as the first step for longer code that may exceed token limits. Follow with append_to_code_file for additional code.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`content`	Yes	Initial content to write to the file
`filename`	No	Optional: Name of the file (default: generated UUID)

Implementation Reference

src/index.ts:204-243 (handler)

The core handler function that creates a new Python code file in the storage directory with the provided content, generating a unique .py filename if not specified, and returns JSON response with file path.

async function initializeCodeFile(content: string, filename?: string) {
    try {
        // Generate a filename if not provided
        let actualFilename;
        if (filename && typeof filename === 'string') {
            // Extract base name without extension
            const baseName = filename.replace(/\.py$/, '');
            // Add a random suffix to ensure uniqueness
            actualFilename = `${baseName}_${randomBytes(4).toString('hex')}.py`;
        } else {
            // Default filename if none provided
            actualFilename = `code_${randomBytes(4).toString('hex')}.py`;
        }
        
        const filePath = join(CODE_STORAGE_DIR, actualFilename);
        
        // Write initial content to file
        await writeFile(filePath, content, 'utf-8');
        
        return {
            type: 'text',
            text: JSON.stringify({
                status: 'success',
                message: 'File initialized successfully',
                file_path: filePath,
                filename: actualFilename
            }),
            isError: false
        };
    } catch (error) {
        return {
            type: 'text',
            text: JSON.stringify({
                status: 'error',
                error: error instanceof Error ? error.message : String(error)
            }),
            isError: true
        };
    }
}

src/index.ts:552-569 (registration)

Tool registration in the ListToolsRequestSchema handler, specifying name, description, and input schema for validation.

{
    name: "initialize_code_file",
    description: "Create a new Python file with initial content. Use this as the first step for longer code that may exceed token limits. Follow with append_to_code_file for additional code.",
    inputSchema: {
        type: "object",
        properties: {
            content: {
                type: "string",
                description: "Initial content to write to the file"
            },
            filename: {
                type: "string",
                description: "Optional: Name of the file (default: generated UUID)"
            }
        },
        required: ["content"]
    }
},

src/index.ts:695-698 (schema)
TypeScript interface defining the expected arguments for the initialize_code_file tool.
```
interface InitializeCodeFileArgs {
    content?: string;
    filename?: string;
}
```

src/index.ts:789-804 (handler)

Dispatch handler case in the CallToolRequestSchema that validates arguments and invokes the initializeCodeFile function, wrapping the result in MCP content format.

case "initialize_code_file": {
    const args = request.params.arguments as InitializeCodeFileArgs;
    if (!args?.content) {
        throw new Error("Content is required");
    }

    const result = await initializeCodeFile(args.content, args.filename);

    return {
        content: [{
            type: "text",
            text: result.text,
            isError: result.isError
        }]
    };
}

MCP Code Executor