file_write
Write content to files for storing notes, documents, or operational data within the AI Ops Hub environment.
Instructions
Записать содержимое в файл
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Путь к файлу | |
| content | Yes | Содержимое для записи |
Implementation Reference
- src/connectors/file-service.ts:30-48 (handler)Core handler function for the file_write tool. Sanitizes the path, creates directories as needed, writes content using fs.writeFile, with logging and error handling.async writeFile(filePath: string, content: string): Promise<void> { try { // Проверяем безопасность пути const safePath = this.sanitizePath(filePath); console.log(`✏️ Запись в файл: ${safePath}`); // Создаем директорию если её нет const dir = path.dirname(safePath); await fs.mkdir(dir, { recursive: true }); await fs.writeFile(safePath, content, 'utf-8'); console.log(`✅ Файл записан: ${safePath} (${content.length} символов)`); } catch (error) { console.error('Ошибка записи файла:', error); throw new Error(`Ошибка записи файла: ${error}`); } }
- src/server.ts:99-116 (registration)Tool registration in the main MCP server's ListToolsRequestSchema handler, defining name, description, and input schema.{ name: 'file_write', description: 'Записать содержимое в файл', inputSchema: { type: 'object', properties: { path: { type: 'string', description: 'Путь к файлу', }, content: { type: 'string', description: 'Содержимое для записи', }, }, required: ['path', 'content'], }, },
- src/server.ts:201-203 (handler)Dispatch case in main server's CallToolRequestSchema handler delegating to FileService.writeFile.case 'file_write': await this.fileService.writeFile(args.path as string, args.content as string); return { content: 'Файл записан' };
- src/transports/http-transport.ts:237-239 (handler)Dispatch case in HTTP transport's /call endpoint handler delegating to FileService.writeFile.case 'file_write': await this.fileService.writeFile(args.path, args.content); result = { message: 'Файл записан' };
- src/connectors/file-service.ts:79-97 (helper)Security helper to sanitize file paths, preventing path traversal attacks by restricting access to the notes directory.private sanitizePath(filePath: string): string { // Убираем потенциально опасные символы const cleanPath = filePath.replace(/[<>:"|?*]/g, ''); // Разрешаем только относительные пути if (path.isAbsolute(cleanPath)) { throw new Error('Абсолютные пути не разрешены'); } // Разрешаем только файлы в notes директории const resolvedPath = path.resolve(this.notesDir, cleanPath); const notesDirResolved = path.resolve(this.notesDir); if (!resolvedPath.startsWith(notesDirResolved)) { throw new Error('Доступ к файлу вне notes директории запрещен'); } return resolvedPath; }