ShadowGit MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with secure, read-only access to your ShadowGit repositories. This enables powerful debugging and code analysis capabilities by giving AI access to your project's fine-grained git history.

What is ShadowGit?

ShadowGit automatically captures every save as a git commit, creating a detailed history of your development process. The MCP server makes this history available to AI assistants for analysis.

Installation

npm install -g shadowgit-mcp-server

Setup with Claude Code

# Add to Claude Code
claude mcp add shadowgit -- shadowgit-mcp-server

# Restart Claude Code to load the server

Setup with Claude Desktop

Add to your Claude Desktop MCP configuration:

macOS/Linux: ~/.config/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "shadowgit": {
      "command": "shadowgit-mcp-server"
    }
  }
}

Requirements

Node.js 18+
ShadowGit app installed and running with tracked repositories
Git available in PATH

Available Commands

`list_repos()`

Lists all ShadowGit-tracked repositories.

await shadowgit.list_repos()

`git({repo, command})`

Executes read-only git commands on a specific repository.

// View recent commits
await shadowgit.git({
  repo: "my-project",
  command: "log --oneline -10"
})

// Check what changed recently
await shadowgit.git({
  repo: "my-project", 
  command: "diff HEAD~5 HEAD --stat"
})

// Find who changed a specific line
await shadowgit.git({
  repo: "my-project",
  command: "blame src/auth.ts"
})

Security

Read-only access: Only safe git commands are allowed
No write operations: Commands like commit, push, merge are blocked
Repository validation: Only ShadowGit repositories can be accessed
Command filtering: Dangerous arguments are blocked

Example Use Cases

Debug Recent Changes

// Find what broke in the last hour
await shadowgit.git({
  repo: "my-app",
  command: "log --since='1 hour ago' --oneline"
})

Trace Code Evolution

// See how a function evolved
await shadowgit.git({
  repo: "my-app", 
  command: "log -L :functionName:src/file.ts"
})

Cross-Repository Analysis

// Compare activity across projects
const repos = await shadowgit.list_repos()
for (const repo of repos) {
  await shadowgit.git({
    repo: repo.name,
    command: "log --since='1 day ago' --oneline"
  })
}

Troubleshooting

No repositories found

Ensure ShadowGit app is installed and has tracked repositories
Check that ~/.shadowgit/repos.json exists

Repository not found

Use list_repos() to see exact repository names
Ensure the repository has a .shadowgit.git directory

Git commands fail

Verify git is installed: git --version
Only read-only commands are allowed
Use absolute paths or repository names from list_repos()

Development

For contributors who want to modify or extend the MCP server:

# Clone the repository (private GitHub repo)
git clone https://github.com/shadowgit/shadowgit-mcp-server.git
cd shadowgit-mcp-server
npm install

# Build
npm run build

# Test
npm test

# Run locally for development
npm run dev

# Test the built version locally
node dist/shadowgit-mcp-server.js

Publishing Updates

# Update version
npm version patch  # or minor/major

# Build and test
npm run build
npm test

# Publish to npm (public registry)
npm publish

License

MIT License - see LICENSE file for details.

ShadowGit - Automatic code snapshot tool
MCP SDK - Model Context Protocol TypeScript SDK

Transform your development history into a powerful AI debugging assistant! 🚀

Deploy Server

HTTP connection URL

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Provides AI assistants with secure, read-only access to ShadowGit repositories for debugging and code analysis. Enables powerful analysis of fine-grained git history captured automatically by ShadowGit's continuous commit tracking.

Related MCP Servers

mcp-git
ver0-project
A
security
A
license
A
quality
Provides comprehensive Git operations as tools for AI assistants and applications. This server enables AI systems to interact with Git repositories, allowing to initialize, fetch, commit, log, status, etc..
Last updated -
10
0
MIT License
GitLab MCP Server
amirsina-mandegari
-
security
F
license
-
quality
Connects AI assistants to GitLab, allowing users to manage merge requests, view reviews, and interact with discussions through natural language queries.
Last updated -
8
GitHub Repository Creator
flickleafy
-
security
A
license
-
quality
Enables AI applications to automatically analyze local repositories and create GitHub repositories with proper configuration, topics, and complete setup workflow.
Last updated -
1
GPL 3.0
Setup Agent MCP
Fibi66
-
security
F
license
-
quality
Enables AI assistants to automatically analyze GitHub repositories and set up development environments by detecting tech stacks, installing dependencies, and verifying project builds. Provides safe tools for repository cloning, file system operations, package installation, and build verification through an allowlisted command system.
Last updated -

View all related MCP servers

ShadowGit MCP Server