Git Repo Browser MCP

Instructions

Implementation Reference

• src/handlers/directory-operations.js:254-308 (handler)

  The core handler function that implements the git_local_changes tool. It uses simpleGit to retrieve the repository status, including staged, modified, new, deleted, and conflicted files, along with diffs for modified files.
  * Handles the git_local_changes tool request * @param {Object} params - Tool parameters * @param {string} params.repo_path - Local repository path * @returns {Object} - Tool response */ export async function handleGitLocalChanges({ repo_path }) { try { // Use the provided local repo path const git = simpleGit(repo_path); // Get status information const status = await git.status(); // Get detailed diff for modified files let diffs = {}; for (const file of status.modified) { diffs[file] = await git.diff([file]); } return { content: [ { type: "text", text: JSON.stringify( { branch: status.current, staged_files: status.staged, modified_files: status.modified, new_files: status.not_added, deleted_files: status.deleted, conflicted_files: status.conflicted, diffs: diffs, }, null, 2 ), }, ], }; } catch (error) { return { content: [ { type: "text", text: JSON.stringify( { error: `Failed to get local changes: ${error.message}` }, null, 2 ), }, ], isError: true, }; } }
• src/server.js:371-383 (schema)

  The input schema definition for the git_local_changes tool, specifying the required repo_path parameter.
  name: "git_local_changes", description: "Get uncommitted changes in the working directory.", inputSchema: { type: "object", properties: { repo_path: { type: "string", description: "The path to the local Git repository", }, }, required: ["repo_path"], }, },
• src/server.js:905-905 (registration)

  Registration of the git_local_changes tool name to its handler function in the handlersMap.
  git_local_changes: handleGitLocalChanges,
• src/server.js:852-854 (registration)

  Registers the tool list including git_local_changes schema for the ListToolsRequest.
  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: this.toolsList, }));
• src/server.js:16-16 (registration)

  Import of the handleGitLocalChanges handler from handlers/index.js.
  handleGitLocalChanges,