@ai-mapping/mcp-nextjs-dev/CHANGELOG.md

MCP server for managing Next.js development processes with AI tools

# 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-01-07

### Added
- Initial release of MCP server for Next.js development process management
- Four core MCP tools:
  - `nextjs_dev_start` - Start Next.js development server asynchronously
  - `nextjs_get_logs` - Retrieve filtered development logs with level, content, and time filtering
  - `nextjs_get_status` - Check server status, uptime, and process information
  - `nextjs_stop_server` - Stop development server gracefully or forcefully
- Real-time log collection and filtering from Next.js processes
- Circular buffer log storage (max 1000 entries) with automatic rotation
- Process lifecycle management with proper cleanup and signal handling
- TypeScript support with strict type checking and ES2022/ESM modules
- CLI interface with debug mode and help documentation
- Official MCP SDK integration with StdioServerTransport
- Zod schema validation for all tool parameters
- Comprehensive error handling with structured JSON responses
- MIT license and professional documentation

### Features
- **Non-blocking execution**: Start Next.js dev servers without hanging Claude Code
- **Smart port detection**: Automatically extract port numbers from script commands
- **Log level detection**: Automatic categorization of logs as error, warn, or info
- **Filtering capabilities**: Filter logs by level, content, time, and line count
- **Process monitoring**: Track server uptime, PID, and status
- **Graceful shutdown**: Proper cleanup of processes and resources
- **Debug mode**: Comprehensive logging for troubleshooting
- **Cross-platform**: Works on Linux, macOS, and Windows with Node.js 22+

### Technical Specifications
- Node.js 22+ required for latest ESM and performance features
- TypeScript 5.x with strict mode and full type safety
- Official `@modelcontextprotocol/sdk` for MCP protocol compliance
- Zod for runtime type validation and schema enforcement
- ESM modules with proper import/export handling
- Singleton pattern for state and process management
- Event-driven architecture for log collection and process monitoring

### Documentation
- Comprehensive README with installation and usage instructions
- Claude Code integration guide with configuration examples
- Troubleshooting section with common issues and solutions
- API documentation for all MCP tools
- Development setup and building instructions
- Professional GitHub repository structure

[1.0.0]: https://github.com/ai-mapping/mcp-nextjs-dev/releases/tag/v1.0.0