shadowgit

ShadowGit is a Model Context Protocol (MCP) server designed to facilitate secure, read-only access for AI assistants to your ShadowGit repositories. By leveraging this tool, you can enable powerful debugging and code analysis capabilities, giving AI access to your project's detailed git history without compromising security. Developers use ShadowGit to enhance their workflow by integrating AI-driven insights directly from their version control data.

Once connected to the ShadowGit server, you can interact with it by sending queries that access your repository's git history. Although specific tools are not documented, you can utilize the server to ask for changes made in a specific file over time, retrieve commit messages, or analyze the evolution of code segments. The best queries involve asking for specific commits or changes, which can help you pinpoint issues or understand code transitions better.

Prerequisites

• Node.js (version 12 or higher recommended)
• Git

Option A: Quick start with npx

You can quickly start using ShadowGit without installing it globally by running:

npx -y blade47/shadowgit-mcp  

Option B: Global install alternative

If you prefer to install ShadowGit globally, you can do so with the following command:

npm install -g blade47/shadowgit-mcp  

After installation, you can start the server using the command:

shadowgit-start  

When configuring ShadowGit, ensure that your repository is structured correctly for optimal performance. You might need to set environment variables such as GIT_REPOSITORY_PATH to point to your local git repository. A common gotcha is forgetting to grant read access to your repository for the AI assistant, which can lead to authorization errors during queries.