Git Mob MCP Server

Git Mob MCP Server

What is Git Mob MCP Server about?

Git Mob MCP Server provides a Model Context Protocol (MCP) endpoint that interfaces with the git‑mob CLI. It lets developers store, select, and apply co‑author information automatically during pair or mob programming sessions, eliminating manual editing of commit messages.

How to use Git Mob MCP Server?

1. Install the server via NPX:

   {
     "mcpServers": {
       "git-mob": {
         "command": "npx",
         "args": ["-y", "git-mob-mcp-server"]
       }
     }
   }
   

2. Run the setup_git_mob tool once to install the git‑mob CLI globally.
3. Use the provided tools (add_team_member, list_team_members, set_mob_session_coauthors, etc.) through an MCP‑compatible client (e.g., Claude Desktop, VS Code) to manage co‑authors and sessions.
4. During a commit, the server automatically appends the appropriate Co‑authored‑by trailers based on the active session.

Key Features

• One‑click setup of the git‑mob CLI globally or locally.
• Team management: add, delete, and list team members by key, name, and email.
• Session handling: set, list, and clear active pairing/mob sessions.
• Automatic co‑author trailers: inject Co‑authored‑by lines into commit messages.
• MCP resources & tools exposed for easy integration with AI assistants and IDE extensions.

Use Cases

• Pair programming: quickly switch co‑authors when swapping partners.
• Mob programming: maintain a persistent list of all contributors for a session.
• CI/CD pipelines: enforce co‑author metadata without manual edits.
• AI‑assisted development: let tools like Claude Desktop invoke MCP tools to manage authorship.

FAQ

• How do I install the server? Use NPX: npx -y git-mob-mcp-server. No global install required.
• Do I need Git installed? Yes, Git v2.32+ must be available on the system.
• What Node version is required? Node 18 or higher.
• Can I use the server locally for testing? Run npm start after cloning the repo; it launches the MCP Inspector for interactive testing.
• How do I clear an active mob session? Invoke the clear_mob_session tool via the MCP client.

Git Mob MCP Server

Node.js server implementing Model Context Protocol (MCP) for git mob CLI app

You can attribute a git commit to more than one author by adding one or more Co-authored-by trailers to the commit's message. Co-authored commits are visible on GitHub. For more information, see here.

This MCP Server will help you add them automatically and also help you store and manage co-authors for pair/mob programming sessions.

Built using @modelcontextprotocol/sdk

Features

• Setup git mob CLI
• Add / delete / list team members
• Choose team members for pairing / mobbing session
• Automatic appending of Co-authored-by in for co-authors in commit messages during pairing / mobbing session

Prerequisites

System Requirements

• Node.js: Version 18 or higher
• git: Git v2.32 or later must be installed and configured
• git-mob CLI: git-mob CLI app must be installed

API

Resources

• git_mob_cli_help: General help and usage information for the Git Mob CLI.
• git_mob_cli_version: The installed version of the Git Mob CLI.

Tools

• setup_git_mob: Sets up git-mob globally for the user.
• setup_git_mob_locally: Sets up git-mob locally for the current repository when it overrides core.hooksPath git configuration variable (e.g when using husky).
• add_team_member: Adds a new team member using their key, name, and email.
• delete_team_member: Deletes a team member by their key.
• list_team_members: Lists all team members that have been added to Git Mob.
• set_mob_session_coauthors: Sets the active pairing or mob session by specifying the keys of the team members to include as coauthors.
• clear_mob_session: Clears the active mob or pairing session.
• list_mob_session_coauthors: Lists all coauthors currently included in the active mob or pairing session.
• list_mob_session_coauthor_trailers: Lists the git Co-authored-by trailers for the coauthors currently included in the active mob or pairing session.
• get_git_mob_cli_help: Displays general help and usage information for the Git Mob CLI.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "git-mob": {
      "command": "npx",
      "args": ["-y", "git-mob-mcp-server"]
    }
  }
}

Usage with VS Code

For installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

NPX

{
  "mcp": {
    "servers": {
      "git-mob": {
        "command": "npx",
        "args": ["-y", "git-mob-mcp-server"]
      }
    }
  }
}

Setup

Run the setup_git_mob MCP tool once to setup git-mob before using other tools

Local Development

For local development and testing of the MCP server:

1. Clone the repository:

   git clone https://github.com/Mubashwer/git-mob-mcp-server.git
   cd git-mob-mcp-server
   

2. Install dependencies:

   npm install
   

3. Start development server:

   npm start
   

   This command will:

   • Build the TypeScript source code in watch mode (automatically rebuilds on file changes)
   • Start the MCP Inspector for testing and debugging the server locally

The MCP Inspector will be available at the URL shown in the terminal output, allowing you to test the server's tools and resources interactively.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.