All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
4.7.0 (2025-06-25)
- ci: add release status and semantic-release badges to README (8ace35f)
- Skip GCP-dependent tests in CI and remove credentials from history (#36) (7e90971), closes #11 #24 #22 #17 #17 #29 #30 #30 #33 #33 #34 #34 #35
4.6.0 (2025-06-25)
- update documentation for v4.5.0 (eee6c8a)
4.5.0 (2025-06-17)
- update documentation for v4.4.0 (0a09a80)
4.4.0 (2025-06-17)
- update documentation for v4.3.0 (d9a56b2)
4.3.0 (2025-06-11)
- update documentation for v4.2.2 (60163c7)
4.2.2 (2025-06-10)
- resolve DATAPROC_CONFIG_PATH environment variable handling (19f039d)
- resolve DATAPROC_CONFIG_PATH environment variable handling (#29) (b71d67a)
- update documentation for v4.2.1 (b328461)
4.2.1 (2025-06-10)
- response-filter: resolve token optimization and status display issues (dd5aa6a)
- Add comprehensive sensitive file management and Git history cleanup guide (12f4442)
- update documentation for v4.2.0 (82a0c25)
- Enhanced release detection may trigger releases for previously undetected conventional commits
- None (fully backward compatible)
- Complete production readiness implementation
Major features:
- Comprehensive CI/CD pipeline with GitHub Actions workflows
- Advanced security middleware and credential management
- Intelligent default parameter injection system
- Enhanced error handling and validation schemas
- Production-ready testing suite with unit, integration, and e2e tests
- Automated release management with semantic versioning
- Complete documentation and community support infrastructure
Technical improvements:
- Resolved all 26 critical ESLint errors for code quality compliance
- Fixed TypeScript compatibility issues with Node.js experimental features
- Implemented proper import/export resolution across all modules
- Added comprehensive security scanning and vulnerability management
- Enhanced MCP protocol implementation with robust error handling
This release establishes the foundation for a production-ready MCP server with enterprise-grade reliability, security, and maintainability.
- 🧠 Knowledge Base Semantic Search - Complete Implementation & Documentation (ecdeaa1)
- add comprehensive dataproc tools testing and fix critical get_zeppelin_url bug (658efb5)
- add production-ready web hosting and enhanced async query tracking (#12) (618e8fd), closes #11
- Add profile management and cluster operations to server request handlers (ef3feae)
- Clean logging, robust GCS output handler, and working TypeScript integration test setup. All debug/info logs now go to stderr and are controlled by LOG_LEVEL. Test runner and imports fixed for ts-node/esm. Marking project milestone. (8975170)
- docs: enable Mermaid diagram rendering in Jekyll documentation (#24) (95464d1)
- enhance CI/CD pipeline with automatic PR merge publishing (eba93bd)
- Enhance OutputParser to support Hive table output parsing (0c85a7a)
- fix list_profiles bug and optimize response format (#22) (68137d4)
- Implement Default Parameter Manager for environment-specific parameter handling (e2cf6e7)
- production-ready dataproc mcp server with comprehensive ci/cd pipeline (ae4fa7e)
- tests: Refactor MCP resource and prompt tests to use service classes and Zod schemas (27a52c9)
- remove outdated cluster profiles and add new setup scripts (7e35040)
- update MCP Client references to Roo and enhance documentation for better integration (5d5d266)
- change package scope to @dipseth for NPM publishing (c6cb45d)
- docs: comprehensive GitHub Pages Jekyll documentation fixes (8ee4919)
- correct package name in post-release validation (a5bb30b)
- enable Jekyll processing for GitHub Pages (5b2975b)
- docs: fix GitHub Pages links and CI/CD workflow (f18774e)
- reduce semantic-release GitHub assets to prevent conflicts (cf9561b)
- remove duplicate config/server.json entry from .gitignore (bb088c6)
- remove invalid 'Document' from TypeDoc kindSortOrder (3ca02e5)
- knowledge: resolve collection mismatch between storage and retrieval (5d9472f)
- resolve ES module build script issue and enhance CI/CD mode (700d1b9)
- resolve GitHub Actions label permissions and enhance TypeScript safety (a1077a5)
- resolve metastore configuration issue and update README (502d088), closes #17 #17
- resolve semantic-release template error in successComment (5426e48)
- smart configuration path resolution for response-filter.json (9356244)
- update GitHub Pages workflow and package references (df356d2)
- Update impersonateServiceAccount in server configuration for correct service account usage (3b9ab78)
- update server.json authentication details and add to .gitignore (bd8e596)
- add GitHub Pages setup guide (f6769dd)
- Enhance README and guides with default parameter management details and user experience improvements (5da9077)
- fix GitHub Pages links and add comprehensive configuration section (6f4ff9e)
- fix Jekyll permalinks for API_REFERENCE and index pages (9a16ba6)
- trigger documentation workflow to test Jekyll fix (36bb2f4)
- update documentation for v3.1.1 (9c51b65)
- update documentation for v3.1.2 (d63c6bf)
- update documentation for v3.1.3 (3c9b295)
- update documentation for v4.0.0 (16fbcef)
- update documentation for v4.1.0 (19032dd)
- update documentation for v4.2.0 (82a0c25)
- update MCP configuration examples to use NPM package (da1f165)
- update npm version badge to use shields.io for better cache management (d3b69da)
- improve CI workflow readability and efficiency (baff59b)
4.2.0 (2025-06-08)
- add comprehensive dataproc tools testing and fix critical get_zeppelin_url bug (8aaa5d8)
- knowledge: resolve collection mismatch between storage and retrieval (77d8c56)
- update documentation for v4.1.0 (d94e33e)
4.1.0 (2025-06-07)
- update documentation for v4.0.0 (19f77c7)
4.0.0 (2025-06-07)
- fix Jekyll permalinks for API_REFERENCE and index pages (132d542)
- trigger documentation workflow to test Jekyll fix (e5b0bd8)
- update documentation for v3.1.3 (caad163)
3.1.3 (2025-06-05)
- enable Jekyll processing for GitHub Pages (9598e37)
- update documentation for v3.1.2 (ff9b7b7)
3.1.2 (2025-06-05)
- docs: comprehensive GitHub Pages Jekyll documentation fixes (8998499)
- update documentation for v3.1.1 (c001503)
3.1.1 (2025-06-05)
- docs: fix GitHub Pages links and CI/CD workflow (985a856)
3.1.0 (2025-06-05)
3.0.0 (2025-06-04)
- Enhanced release detection may trigger releases for previously undetected conventional commits
- enhance CI/CD pipeline with automatic PR merge publishing (59ffe57)
- update npm version badge to use shields.io for better cache management (a95db42)
2.1.1 (2025-06-03)
- smart configuration path resolution for response-filter.json (4eda469)
2.1.0 (2025-06-03)
- 🧠 Knowledge Base Semantic Search - Complete Implementation & Documentation (808f97d)
2.0.3 (2025-06-02)
- fix GitHub Pages links and add comprehensive configuration section (12e8f2c)
2.0.2 (2025-05-31)
- resolve semantic-release template error in successComment (757b95d)
2.0.1 (2025-05-31)
- resolve GitHub Actions label permissions and enhance TypeScript safety (c8ab9df)
2.0.0 (2025-05-31)
- None (fully backward compatible)
1.1.6 (2025-05-30)
- remove duplicate config/server.json entry from .gitignore (bbc25a2)
1.1.5 (2025-05-30)
- update server.json authentication details and add to .gitignore (5afa561)
- update MCP configuration examples to use NPM package (4d22183)
1.1.4 (2025-05-30)
- correct package name in post-release validation (a201af0)
1.1.3 (2025-05-30)
- reduce semantic-release GitHub assets to prevent conflicts (f16f124)
1.1.2 (2025-05-30)
- remove invalid 'Document' from TypeDoc kindSortOrder (38ef045)
- improve CI workflow readability and efficiency (0bfb268)
1.1.1 (2025-05-30)
- update GitHub Pages workflow and package references (a5e25c1)
- add GitHub Pages setup guide (a84ab4e)
1.1.0 (2025-05-30)
- update MCP Client references to Roo and enhance documentation for better integration (44f5e8e)
1.0.2 (2025-05-30)
1.0.1 (2025-05-30)
- resolve ES module build script issue and enhance CI/CD mode (387fe7c)
- Complete production readiness implementation
Major features:
- Comprehensive CI/CD pipeline with GitHub Actions workflows
- Advanced security middleware and credential management
- Intelligent default parameter injection system
- Enhanced error handling and validation schemas
- Production-ready testing suite with unit, integration, and e2e tests
- Automated release management with semantic versioning
- Complete documentation and community support infrastructure
Technical improvements:
- Resolved all 26 critical ESLint errors for code quality compliance
- Fixed TypeScript compatibility issues with Node.js experimental features
- Implemented proper import/export resolution across all modules
- Added comprehensive security scanning and vulnerability management
- Enhanced MCP protocol implementation with robust error handling
This release establishes the foundation for a production-ready MCP server with enterprise-grade reliability, security, and maintainability.
- Add profile management and cluster operations to server request handlers (ac071da)
- Clean logging, robust GCS output handler, and working TypeScript integration test setup. All debug/info logs now go to stderr and are controlled by LOG_LEVEL. Test runner and imports fixed for ts-node/esm. Marking project milestone. (00c4c89)
- Enhance OutputParser to support Hive table output parsing (4a1fa0e)
- Implement Default Parameter Manager for environment-specific parameter handling (c44e818)
- production-ready dataproc mcp server with comprehensive ci/cd pipeline (66efdb0)
- tests: Refactor MCP resource and prompt tests to use service classes and Zod schemas (5ba4c78)
- remove outdated cluster profiles and add new setup scripts (b46e542)
- Update impersonateServiceAccount in server configuration for correct service account usage (2be7a68)
- Enhance README and guides with default parameter management details and user experience improvements (38146c5)
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
-
Production-ready npm package configuration
- Removed private flag for public distribution
- Added comprehensive package metadata and keywords
- Enhanced npm scripts for development and production use
- Added engines requirement for Node.js >=18.0.0
-
Automated setup and installation
- Interactive setup script (
npm run setup) - Post-install script for automatic directory creation
- Configuration validation script (
npm run validate) - Server management scripts (
npm run stop,npm run restart) - Template configuration files for easy setup
- Interactive setup script (
-
Enhanced development tooling
- ESLint and Prettier configuration
- Test coverage reporting with nyc
- Security audit scripts
- Automated formatting and linting
-
Security hardening (Phase 2)
- Comprehensive input validation with Zod schemas
- Rate limiting and abuse prevention
- Credential management and validation
- Audit logging for security events
- Threat detection for injection attacks
- Secure defaults and security headers
- GCP resource constraint validation
-
Documentation enhancement (Phase 3)
- Enhanced Quick Start Guide with 5-minute setup
- Common use cases and practical examples
- Comprehensive troubleshooting guide
- Multi-environment configuration examples
- Complete API reference with 485 lines of documentation
- Interactive HTML documentation generator
- Auto-generated API docs from Zod schemas
-
CI/CD Setup (Phase 4)
- Comprehensive GitHub Actions workflows for automated testing and deployment
- Multi-Node.js version testing matrix (18, 20, 22)
- Automated semantic versioning and release management
- Dependency management with automated updates and security scanning
- Documentation pipeline with GitHub Pages deployment
- Jest testing framework with TypeScript support
- Code coverage reporting with 90% threshold requirements
- ESLint and Prettier integration for code quality
- Security scanning and vulnerability management
- Automated NPM publishing on releases
- Custom CI/CD Ops mode for workflow management
- Comprehensive CI/CD documentation and troubleshooting guide
-
Testing & Validation (Phase 5)
- Enhanced integration tests for authentication methods
- End-to-end workflow testing with mock MCP server
- Performance benchmarking with configurable thresholds
- Chaos testing for resilience and error handling validation
- Multi-environment validation across dev/staging/production
- Comprehensive testing infrastructure with custom test runners
- Performance monitoring with memory usage tracking
- Cross-platform compatibility testing
- Authentication method validation across all supported types
- Service account impersonation testing
- Credential expiration and rotation monitoring tests
-
Release Preparation (Phase 6)
- Semantic versioning configuration with conventional commits
- Automated release workflow with semantic-release
- Comprehensive release preparation script with validation
- Distribution setup with proper asset packaging
- Release notes generation with git log integration
- Package validation and optimization
- Multi-branch release strategy (main, develop, release/*)
- NPM publishing automation with GitHub releases
-
Community Readiness (Phase 7)
- Comprehensive contributing guidelines (385 lines)
- GitHub issue templates for bug reports and feature requests
- Pull request template with detailed checklists
- Code of conduct and community standards
- Development workflow documentation
- Contribution recognition system
- Open source preparation with MIT license
- Community support and response time commitments
-
Template configurations
templates/default-params.json.template- Default parameter configurationtemplates/server.json.template- Server configuration with authenticationtemplates/mcp-settings.json.template- MCP client settings template
-
Comprehensive documentation
- Security Guide (
docs/SECURITY_GUIDE.md) - 267 lines - Configuration Examples (
docs/CONFIGURATION_EXAMPLES.md) - 434 lines - API Reference (
docs/API_REFERENCE.md) - 485 lines - Interactive documentation (
docs/api-interactive.html) - Auto-generated docs (
docs/API_AUTO_GENERATED.md) - Enhanced Quick Start Guide (
QUICK_START.md) - Production readiness plan documentation
- Security Guide (
-
Open source preparation
- MIT License
- Comprehensive CHANGELOG.md
- Repository configuration for
dipseth/dataproc-mcp
- Package name: Changed from
dataproc-serverto@dataproc/mcp-server - Version: Bumped to 1.0.0 for production release
- Files included: Expanded to include templates, scripts, and documentation
-
Smart default parameter management (existing feature)
- Intelligent parameter injection for common parameters
- Multi-environment support
- Backward compatibility with explicit parameters
-
Comprehensive toolset (existing feature)
- 16 tools covering cluster management and job execution
- MCP resource exposure for configuration access
- Environment-independent authentication
- Enhanced input validation preparation
- Credential sanitization framework
- Security audit integration
- Default parameter management system
- Resource exposure via MCP protocol
- Service account impersonation support
- Authentication strategy with fallback mechanisms
- Performance improvements (53-58% faster operations)
- Comprehensive testing infrastructure
- Basic MCP server for Google Cloud Dataproc
- Cluster creation and management tools
- Hive query execution
- Profile-based cluster configuration
- Basic authentication support
- Enhanced security features
- Rate limiting implementation
- Advanced monitoring and logging
- Performance optimizations
- CI/CD pipeline integration
- Automated testing enhancements
- Community contribution guidelines
- Documentation website
- Breaking changes for improved API design
- Advanced cluster management features
- Multi-cloud support exploration
- Enterprise features