io.github.greenmtnsun/giteasy

Official22 tools

by greenmtnsun · PowerShell

21 plain-English git tools as an MCP server. No jargon.

Provides 21 plain-English git commands for version control without technical jargon.

Captured live from the server via tools/list.

push

Send already-committed work to the remote without making a new commit. Pushes the current branch; on a branch's first push, sets the remote branch as its upstream automatically.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
remoteNamestring
Remote name. Default origin.

show_diagnostic

Show git repository diagnostic info: current branch, upstream, HEAD SHA, remote URLs, and status summary.

Parameters (1)

workingDirectorystring
Git repo path. Default current directory.

set_vault

Configure the git credential helper to use a specific vault path. Returns new credential helper value.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
vaultPathstring
Path to the credential helper vault executable.

restore_file

Restore a single file to its HEAD state, discarding uncommitted changes. Returns restored file path.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
filePathstring
Repo-relative path to the file to restore.

reset_login

Clear stored git credentials by unsetting the credential helper in local git config. Returns confirmation.

Parameters (1)

workingDirectorystring
Git repo path. Default current directory.

set_ssh

Change a remote URL to its SSH equivalent. Returns old and new remote URLs.

Parameters (3)

workingDirectorystring
Git repo path. Default current directory.
remoteNamestring
Remote name to update. Default origin.
sshUrlstring
New SSH remote URL, e.g. git@github.com:owner/repo.git.

save_work

Stage changes, commit with a message, and optionally push to remote. Returns commit SHA and push result.

Parameters (4)

workingDirectorystring
Git repo path. Default current directory.
messagestring
Commit message.
pushToRemoteboolean
Push to remote after commit. Default false.
filesarray | null
Files to commit. Default empty (commits all changes).

get_vault_status

Report current git credential helper configuration. Returns helper name and scope.

Parameters (1)

workingDirectorystring
Git repo path. Default current directory.

test_login

Test whether git credentials are working by attempting ls-remote against the origin. Returns success/failure and remote refs count.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
remoteNamestring
Remote to test. Default origin.

show_releases

List all tags/releases in the repository, newest first. Returns tag names, target SHAs, and annotation messages.

Parameters (1)

workingDirectorystring
Git repo path. Default current directory.

show_change

Show the diff for a specific file or all changed files. Returns unified diff text.

Parameters (3)

workingDirectorystring
Git repo path. Default current directory.
filePathstring
Repo-relative file path. If empty, shows all.
stagedboolean
Show staged diff. Default false.

new_release

Create an annotated git tag and push it to the remote. Returns the tag name and target commit SHA.

Parameters (4)

workingDirectorystring
Git repo path. Default current directory.
tagNamestring
Tag name, e.g. v1.2.0.
messagestring
Annotation message for the tag.
remoteNamestring
Remote to push to. Default origin.

find_changes

List changed files: staged, unstaged, and untracked. Returns file counts and paths by status group.

Parameters (1)

workingDirectorystring
Git repo path. Default current directory.

show_remote

Show all remote names and their fetch/push URLs. Returns list of remotes with URL and type.

Parameters (1)

workingDirectorystring
Git repo path. Default current directory.

get_updates

Fetch from remote and show incoming commits not yet in local branch. Returns count and commit summaries.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
remoteNamestring
Remote name. Default origin.

undo_changes

Discard uncommitted changes. If filePath given, restores that file; otherwise restores all tracked files. Returns list of restored paths.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
filePathstring
Repo-relative file path to undo. If empty, undoes all tracked changes.

switch_work

Switch to an existing branch. Returns the branch switched to and current HEAD SHA.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
branchNamestring
Name of the branch to switch to.

search_history

Search commit history for commits whose message matches a search term. Returns matching commits with SHA, author, date, and message.

Parameters (3)

workingDirectorystring
Git repo path. Default current directory.
searchTermstring
Text to search for in commit messages.
limitinteger
Max commits to return. Default 20.

show_history

Show recent commit history. Returns commits with SHA, author, date, and message.

Parameters (3)

workingDirectorystring
Git repo path. Default current directory.
limitinteger
Number of commits to return. Default 20.
branchNamestring
Branch name. Default current branch.

new_work_branch

Create a new branch from current HEAD and switch to it. Returns branch name and base commit SHA.

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
branchNamestring
Name of the new branch.

set_token

Store a personal access token for HTTP git authentication. Returns confirmation (token value is never echoed).

Parameters (2)

workingDirectorystring
Git repo path. Default current directory.
tokenstring
Personal access token to store.

clear_junk

Remove untracked files and directories from the working tree (git clean -fd). Returns list of removed paths.

Parameters (1)

workingDirectorystring
Git repo path. Default current directory.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "giteasy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://giteasy-mcp.azurewebsites.net/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.