Repo Onboarding

About

This MCP server for Gemini CLI performs static analysis on local Python repositories. It intelligently detects environment configurations, dependencies, test setups, and developer command entry points from various files like `requirements.txt`, `pyproject.toml`, `Makefile`, and custom scripts. By producing structured JSON output about the repository's characteristics, it empowers Gemini CLI to automatically generate and keep current a comprehensive `ONBOARDING.md` file. This automated process streamlines the integration of new team members by providing essential setup and usage information without manual documentation effort, ensuring consistency and accuracy across projects.

Key Features

• 1 GitHub stars
• Detects Python environment configurations and dependencies (e.g., `requirements*.txt`, `pyproject.toml`, `Pipfile`).
• Identifies testing frameworks (`pytest`, `tox`, `nox`) and common developer commands from `Makefile` targets or repo scripts.
• Reports key documentation and configuration files like `README*`, `CONTRIBUTING*`, `.pre-commit-config.*`, and `tox.ini`.
• Applies smart filtering to ignore test fixtures, build artifacts, and environment-specific files during analysis.
• Manages `ONBOARDING.md` files, supporting operations to read, write, overwrite, append, and create backups.

Use Cases

• Automating the creation of initial `ONBOARDING.md` documentation for new Python repositories.
• Maintaining up-to-date onboarding instructions as a Python repository evolves over time.
• Standardizing the onboarding process and documentation across multiple Python projects within an organization.