Desktop Tools
Provides a minimal Model Context Protocol server and CLI for inspecting source trees and managing workspaces using ripgrep and Git.
About
Desktop Tools offers a lightweight Model Context Protocol (MCP) server and a powerful command-line interface to streamline the inspection and management of code repositories across configured workspaces. It leverages popular tools like ripgrep and Git to enable efficient text searching, git history analysis, and repository mapping. Beyond core introspection, it includes features for project scaffolding, tracking recently modified files, and generating comprehensive repository snapshots, with optional integration into MLflow for robust tracking and analysis. Designed for developers, it enhances productivity with robust caching, concurrency controls, and detailed metrics.
Key Features
- Workspace configuration via YAML with environment overrides and security helpers for path validation.
- 0 GitHub stars
- Minimal MCP server registering tools for searching, Git analysis, repository mapping, scaffolding, and recent file tracking.
- Ripgrep and Git adapters with configurable timeouts, bounded filesystem concurrency, and rich performance metrics.
- Persistent disk caching for `repo_map` and in-process TTL caching for `search_text`, with per-request opt-out.
- New `snapshot` tool to compose repository state into a JSON artifact, optionally logged to MLflow, with a Python client for agents.
Use Cases
- Capture and log comprehensive repository snapshots, including environment markers, to MLflow for project tracking and analysis.
- Automate the creation of new projects using built-in or user-defined templates via the scaffold tool.
- Efficiently search codebases, analyze Git history, and map repository structures across configured workspaces.
