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

npm install
npm run build

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

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

Tests and Docker

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.