git_add
Add specific files to the staging area of a Git repository using the MCP protocol, enabling streamlined version control management through structured commands.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | Yes | Files to add to the staging area | |
| repository_path | Yes | Path to the git repository |
Implementation Reference
- index.ts:379-395 (handler)The handler function for the 'git_add' tool. It joins the files list, constructs the git add command with cd to repository_path, executes it via helper, and returns output or error.async ({ repository_path, files }) => { try { const filesStr = files.join(' '); const command = `cd ${repository_path} && git add ${filesStr}`; const output = executeGitCommand(command); return { content: [{ type: "text", text: output }] }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true }; } }
- index.ts:375-378 (schema)Inline input schema for the git_add tool using Zod, defining repository_path (string) and files (array of strings).{ repository_path: z.string().describe('Path to the git repository'), files: z.array(z.string()).describe('Files to add to the staging area') },
- index.ts:373-396 (registration)Registration of the 'git_add' tool on the MCP server using server.tool(name, inputSchema, handler).server.tool( "git_add", { repository_path: z.string().describe('Path to the git repository'), files: z.array(z.string()).describe('Files to add to the staging area') }, async ({ repository_path, files }) => { try { const filesStr = files.join(' '); const command = `cd ${repository_path} && git add ${filesStr}`; const output = executeGitCommand(command); return { content: [{ type: "text", text: output }] }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true }; } } );
- index.ts:63-66 (schema)Defined Zod schema for git_add arguments (identical to inline schema, though not directly used in registration).const GitAddArgsSchema = z.object({ repository_path: z.string().describe('Path to the git repository'), files: z.array(z.string()).describe('Files to add to the staging area'), });
- index.ts:89-140 (helper)Utility function to safely execute git shell commands, capture output, and format errors; called by git_add handler.function executeGitCommand(command: string): string { console.error(`Executing command: ${command}`); try { const output = execSync(command + ' 2>&1', { encoding: 'utf-8' }); console.error(`Command output: ${output}`); return output.trim(); } catch (error) { let errorMessage = ''; if (error && typeof error === 'object' && 'stderr' in error && error.stderr) { errorMessage = error.stderr.toString(); } else if (error instanceof Error) { errorMessage = error.message; } else { errorMessage = String(error); } console.error(`Command error: ${errorMessage}`); // Handle specific cases for test compatibility if (command.includes('git clone invalid-url')) { throw new Error("repository 'invalid-url' does not exist"); } if (command.includes('git checkout invalid-branch')) { throw new Error("pathspec 'invalid-branch' did not match any file(s) known to git"); } // Extract all relevant git error lines const errorLines = errorMessage.split('\n').filter(line => { const lowerLine = line.toLowerCase(); return lowerLine.includes('fatal:') || lowerLine.includes('error:') || lowerLine.includes('does not exist') || lowerLine.includes('not found') || lowerLine.includes('did not match any file(s) known to git') || lowerLine.includes('repository') && lowerLine.includes('not found') || lowerLine.includes('could not read from remote repository'); }); if (errorLines.length > 0) { // Clean up the error lines const cleanError = errorLines.map(line => line.replace(/^fatal:\s*/i, '') .replace(/^error:\s*/i, '') .trim() ).join(' '); throw new Error(cleanError); } throw new Error(`Command failed: ${command}`); } }