Enhanced Knowledge Graph Memory Server

# Contributing to Enhanced Memory MCP Thanks for your interest in contributing to the Enhanced Memory MCP server! Here's how you can help make this project better. ## About This Project This is an enhanced fork of the official Model Context Protocol memory server, with Phase 1-4 enhancements adding: - Automatic timestamp tracking (createdAt, lastModified) - Advanced search and analytics (date range, statistics) - Categorization (tags, importance levels) - Multi-format export (JSON, CSV, GraphML) **Repository**: https://github.com/danielsimonjr/mcp-servers **Documentation**: [README.md](README.md) | [CHANGELOG.md](CHANGELOG.md) | [WORKFLOW.md](WORKFLOW.md) ## Development Workflow See [WORKFLOW.md](WORKFLOW.md) for detailed development instructions. Quick start: ```bash # Navigate to source cd c:/mcp-servers/memory-mcp/src/memory # Install dependencies npm install # Build npm run build # Run tests npm test ``` ## What We Welcome ### Bug Fixes - Fix issues with timestamp tracking - Resolve export formatting problems - Address search/filter bugs - Improve backward compatibility ### Usability Improvements - Better error messages - Performance optimizations - Enhanced documentation - Improved test coverage ### Feature Enhancements We're particularly interested in: - Additional export formats - More sophisticated filtering options - Performance improvements for large graphs - Enhanced statistics and analytics - Better tag management features ### Testing - Use **vitest** as the test framework - Add tests for new features - Ensure backward compatibility - Test with various data sizes ## What We're Selective About - **Breaking changes** - Must maintain backward compatibility - **Highly opinionated features** - Should align with core memory MCP purpose - **Massive scope changes** - Discuss in an issue first ## How to Contribute 1. **Fork the repository** ```bash gh repo fork danielsimonjr/mcp-servers ``` 2. **Create a feature branch** ```bash cd c:/mcp-servers/memory-mcp git checkout -b feature/your-feature-name ``` 3. **Make your changes** - Edit files in `src/memory/` - Follow existing code style - Add/update tests - Update documentation 4. **Build and test** ```bash cd src/memory npm run build npm test ``` 5. **Commit your changes** ```bash cd c:/mcp-servers/memory-mcp git add . git commit -m "Description of your changes" ``` 6. **Push and create PR** ```bash git push origin feature/your-feature-name # Create PR on GitHub ``` ## Code Style Guidelines - Follow TypeScript best practices - Use meaningful variable names - Add JSDoc comments for public methods - Keep functions focused and small - Maintain consistent indentation (2 spaces) ## Testing Guidelines - Test new features thoroughly - Include edge cases - Test backward compatibility - Verify export formats are valid - Test with empty graphs and large graphs ## Documentation When adding features: - Update README.md with new tools/functionality - Add entries to CHANGELOG.md - Update WORKFLOW.md if development process changes - Include usage examples ## Pull Request Process 1. **Title**: Clear, descriptive summary 2. **Description**: - What changed - Why it changed - How to test it 3. **Tests**: Include test results 4. **Documentation**: Update relevant docs 5. **Backward Compatibility**: Confirm no breaking changes ## Questions or Issues? - **Bug Reports**: Open an issue with detailed reproduction steps - **Feature Requests**: Open an issue describing the use case - **Questions**: Check existing issues or open a new one ## Community This project follows the [Model Context Protocol community guidelines](https://modelcontextprotocol.io/community/communication). ## License By contributing, you agree that your contributions will be licensed under the MIT License. --- Thank you for helping make Enhanced Memory MCP better for everyone! 🎉