@cyanheads/git-mcp-server/dist/mcp-server/tools/gitDiff/registration.js

An MCP (Model Context Protocol) server enabling LLMs and AI agents to interact with Git repositories. Provides tools for comprehensive Git operations including clone, commit, branch, diff, log, status, push, pull, merge, rebase, worktree, tag management,

/**
 * @fileoverview Handles registration and error handling for the git_diff tool.
 * @module src/mcp-server/tools/gitDiff/registration
 */
import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
import { diffGitChanges, GitDiffOutputSchema, GitDiffBaseSchema, } from "./logic.js";
const TOOL_NAME = "git_diff";
const TOOL_DESCRIPTION = "Shows changes between commits, commit and working tree, etc. Can show staged changes or diff specific files. An optional 'includeUntracked' parameter (boolean) can be used to also show the content of untracked files. Returns the diff output as plain text.";
/**
 * Registers the git_diff tool with the MCP server instance.
 * @param server The MCP server instance.
 * @param getWorkingDirectory Function to get the session's working directory.
 * @param getSessionId Function to get the session ID from context.
 */
export const registerGitDiffTool = async (server, getWorkingDirectory, getSessionId) => {
    const operation = "registerGitDiffTool";
    const context = requestContextService.createRequestContext({ operation });
    server.registerTool(TOOL_NAME, {
        title: "Git Diff",
        description: TOOL_DESCRIPTION,
        inputSchema: GitDiffBaseSchema.shape,
        outputSchema: GitDiffOutputSchema.shape,
        annotations: {
            readOnlyHint: true,
            destructiveHint: false,
            idempotentHint: true,
            openWorldHint: false,
        },
    }, async (params, callContext) => {
        const handlerContext = requestContextService.createRequestContext({
            toolName: TOOL_NAME,
            parentContext: callContext,
        });
        try {
            const sessionId = getSessionId(handlerContext);
            const result = await diffGitChanges(params, {
                ...handlerContext,
                getWorkingDirectory: () => getWorkingDirectory(sessionId),
            });
            return {
                structuredContent: result,
                content: [
                    {
                        type: "text",
                        text: result.diff,
                        contentType: "text/plain; charset=utf-8",
                    },
                ],
            };
        }
        catch (error) {
            logger.error(`Error in ${TOOL_NAME} handler`, {
                error,
                ...handlerContext,
            });
            const mcpError = ErrorHandler.handleError(error, {
                operation: `tool:${TOOL_NAME}`,
                context: handlerContext,
                input: params,
            });
            return {
                isError: true,
                content: [{ type: "text", text: `Error: ${mcpError.message}` }],
                structuredContent: {
                    code: mcpError.code,
                    message: mcpError.message,
                    details: mcpError.details,
                },
            };
        }
    });
    logger.info(`Tool '${TOOL_NAME}' registered successfully.`, context);
};
//# sourceMappingURL=registration.js.map