# Local Repo Automation MCP

An MCP server for inspecting local Git repositories and automating common delivery tasks through `git` and the GitHub CLI (`gh`): status, diffs, commits, pull requests, and deployments.

## Setup

```powershell
npm install
npm run build
```

Set an allowlist before starting the server. Use semicolons on Windows:

```powershell
$env:MCP_ALLOWED_ROOTS = "E:\src;E:\work"
$env:MCP_DEPLOY_COMMAND = "npm run deploy"
npm start
```

## Tests and Docker

```powershell
npm.cmd test
npm.cmd run typecheck
npm.cmd run build
docker build --tag local-repo-automation-mcp:latest .
```

GitHub Actions runs all three Node checks and the Docker build on every push and pull request. Start Docker Desktop before running the image build locally.

The GitHub CLI must be installed and authenticated for pull request creation. Deployment is disabled unless `MCP_DEPLOY_COMMAND` is set. All mutating operations require `confirm: true`.

Add `.vscode/mcp.json` to a VS Code workspace and build this project before connecting the server.

## Tools

- `list_repositories`: list Git repositories below an allowed directory.
- `repository_status`: inspect branch and working-tree state.
- `repository_diff`: read unstaged or staged diffs.
- `commit_repository`: stage selected paths and create a commit.
- `create_pull_request`: push a branch and open a GitHub pull request with `gh`.
- `deploy_repository`: run the configured deployment command in a repository.