fast_write_file
Write or modify files with automatic directory creation, append support, encoding options, and emoji removal.
Instructions
Writes or modifies a file (provides emoji guidelines)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | File path | |
| content | Yes | File content | |
| encoding | No | Text encoding | utf-8 |
| create_dirs | No | Automatically create directories | |
| append | No | Append mode | |
| force_remove_emojis | No | Force remove emojis (default: false) |
Implementation Reference
- api/server.ts:482-520 (handler)The handler function that executes the fast_write_file tool logic. It validates the path, optionally creates directories, writes or appends content to the file, and returns file metadata.
async function handleWriteFile(args: any) { const { path: filePath, content, encoding = 'utf-8', create_dirs = true, append = false } = args; let targetPath: string; if (path.isAbsolute(filePath)) { targetPath = filePath; } else { targetPath = path.join(process.cwd(), filePath); } if (!isPathAllowed(targetPath)) { throw new Error(`Access denied to path: ${targetPath}`); } const resolvedPath = path.resolve(targetPath); if (create_dirs) { const dir = path.dirname(resolvedPath); await fs.mkdir(dir, { recursive: true }); } if (append) { await fs.appendFile(resolvedPath, content, encoding as BufferEncoding); } else { await fs.writeFile(resolvedPath, content, encoding as BufferEncoding); } const stats = await fs.stat(resolvedPath); return { message: `File ${append ? 'appended' : 'written'} successfully`, path: resolvedPath, size: stats.size, size_readable: formatSize(stats.size), encoding: encoding, mode: append ? 'append' : 'write', timestamp: new Date().toISOString() }; } - api/server.ts:123-137 (schema)The input schema definition for the fast_write_file tool within the MCP_TOOLS array. Defines parameters: path (required), content (required), encoding, create_dirs, append.
{ name: 'fast_write_file', description: '파일을 쓰거나 수정합니다', inputSchema: { type: 'object', properties: { path: { type: 'string', description: '파일 경로' }, content: { type: 'string', description: '파일 내용' }, encoding: { type: 'string', description: '텍스트 인코딩', default: 'utf-8' }, create_dirs: { type: 'boolean', description: '디렉토리 자동 생성', default: true }, append: { type: 'boolean', description: '추가 모드', default: false } }, required: ['path', 'content'] } }, - api/server.ts:326-328 (registration)The registration/call dispatch entry for fast_write_file in the tools/call switch statement, mapping the tool name to the handleWriteFile handler function.
case 'fast_write_file': result = await handleWriteFile(args); break;