Cut-Copy-Paste Clipboard Server

# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [1.0.0] - 2025-10-09 ### Added - Initial release of MCP Cut-Copy-Paste Clipboard Server - **6 MCP Tools**: copy_lines, cut_lines, paste_lines, show_clipboard, undo_last_paste, get_operation_history - **Session-Based Clipboard**: Each session maintains independent clipboard state with 24-hour timeout - **Undo Support**: Revert paste operations with complete file snapshots - **Audit Trail**: SQLite-based operation logging for debugging and history tracking - **Session Management**: Automatic cleanup with 24-hour timeout and secure session IDs - **NPX Ready**: Easy installation and updates via `npx cut-copy-paste-mcp` - **Unicode Support**: Full support for international characters and emoji (UTF-8) - **Binary File Detection**: Automatically rejects PNG, PDF, JPEG, GIF, ZIP, and other binary formats - **Flexible Line Insertion**: Supports paste at line 0 (beginning of file) - **Multi-Target Paste**: Paste clipboard content to multiple files in a single operation - **Line Ending Preservation**: Maintains original line endings (LF, CRLF) - **File Size Limits**: 10MB maximum clipboard and file size for safety - **Comprehensive Testing**: 156 passing tests across 10 test suites with 90%+ coverage - **Integration Tests**: End-to-end workflow testing for copy→paste→undo cycles - **Edge Case Handling**: Large files (10,000+ lines), Unicode, rapid operations, session isolation ### Security - Path resolution using Node's `resolve()` to prevent directory traversal - Input validation for all file paths and line numbers - Write permission checks before file modifications - Error messages sanitized to prevent sensitive data leakage - Binary file signature detection for security ### Performance - Database indexes for session queries, operations log, and paste history - WAL (Write-Ahead Logging) mode for better SQLite concurrency - Efficient binary detection (checks only first 8KB of files) - File size limits to prevent memory exhaustion ### Documentation - Comprehensive README with installation, configuration, and usage examples - MCP configuration instructions for Claude Code, Cursor, and Cline - AGENTIC_USAGE.md guide for AI agents - ARCHITECTURE.md documenting design decisions - CLAUDE.md with project guidelines and TDD workflow - TODO.md tracking complete 15-phase implementation plan ### Technical Details - Built with TypeScript 5.7 and ES modules - SQLite database with better-sqlite3 - Model Context Protocol (MCP) SDK 1.0 - Jest testing framework with experimental VM modules - Strict Test-Driven Development (TDD) methodology - Four database tables: sessions, clipboard_buffer, operations_log, paste_history [1.0.0]: https://github.com/Pr0j3c7t0dd-Ltd/cut-copy-paste-mcp/releases/tag/v1.0.0