AI Ops Hub

Instructions

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;
  }