- Fork the repository and create a feature branch
- Make your changes with clear, atomic commits
- Open a Pull Request with a description that clearly explains:
- What the change does
- Why it's needed
- Any breaking changes or migration steps
- Python 3.12 or higher
uvfor dependency management
Create and activate a virtual environment:
uv venv .venv
source .venv/bin/activate # Always activate before running scriptsInstall all project dependencies:
uv pip install .To add new dependencies during development:
uv pip install <package>Install pre-commit hooks to automatically run linting and tests before commits:
./scripts/setup-hooks.shThis ensures code quality by running:
- Ruff linting
- Pyright type checking
- Unit tests
The server should now be ready to use with your MCP-compatible editor.
Additional testing tools are available in the tests/ directory.