@andrebuzeli/git-mcp 10.0.9 → 11.0.0

package/dist/index.js

@@ -1,224 +0,0 @@
-#!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { ProviderManager } from './providers/providerManager.js';
-import { MCPError } from './utils/errors.js';
-import { IsomorphicGitAdapter } from './utils/gitAdapter.js';
-import { GitFilesTool } from './tools/gitFiles.js';
-import { GitWorkflowTool } from './tools/gitWorkflow.js';
-import { GitBranchesTool } from './tools/gitBranches.js';
-import { GitIssuesTool } from './tools/gitIssues.js';
-import { GitPullsTool } from './tools/gitPulls.js';
-import { GitTagsTool } from './tools/gitTags.js';
-import { GitReleaseTool } from './tools/gitRelease.js';
-import { GitRemoteTool } from './tools/gitRemote.js';
-import { GitResetTool } from './tools/gitReset.js';
-import { GitStashTool } from './tools/gitStash.js';
-import { GitConfigTool } from './tools/gitConfig.js';
-import { GitMonitorTool } from './tools/gitMonitor.js';
-import { GitBackupTool } from './tools/gitBackup.js';
-import { GitArchiveTool } from './tools/gitArchive.js';
-import { GitSyncTool } from './tools/gitSync.js';
-import { GitPackagesTool } from './tools/gitPackages.js';
-import { GitAnalyticsTool } from './tools/gitAnalytics.js';
-import { GitUploadTool } from './tools/gitUpload.js';
-import { GitUpdateTool } from './tools/gitUpdate.js';
-import { GitHistoryTool } from './tools/gitHistory.js';
-import { GitFixTool } from './tools/gitFix.tool.js';
-import { GitIgnoreTool } from './tools/gitIgnore.js';
-import { GIT_PROMPTS } from './prompts/gitPrompts.js';
-import TOOLS_GUIDE from './resources/toolsGuide.js';
-import { Logger, logToolExecution, logSecurityEvent, logPerformanceMetric } from './utils/logger.js';
-async function main() {
-    const providerManager = new ProviderManager();
-    const gitAdapter = new IsomorphicGitAdapter(providerManager);
-    const logger = Logger.getInstance();
-    // Skip validation on startup to prevent hanging (validation happens on first use)
-    // Provider validation moved to lazy initialization
-    // Register all 22 Git tools
-    const tools = [
-        new GitWorkflowTool(),
-        new GitFilesTool(),
-        new GitBranchesTool(),
-        new GitIssuesTool(),
-        new GitPullsTool(),
-        new GitTagsTool(),
-        new GitReleaseTool(),
-        new GitRemoteTool(),
-        new GitResetTool(),
-        new GitStashTool(),
-        new GitConfigTool(),
-        new GitMonitorTool(),
-        new GitBackupTool(),
-        new GitArchiveTool(),
-        new GitSyncTool(),
-        new GitPackagesTool(),
-        new GitAnalyticsTool(),
-        new GitUploadTool(),
-        new GitUpdateTool(),
-        new GitHistoryTool(),
-        new GitFixTool(),
-        new GitIgnoreTool(),
-    ];
-    // Register resources
-    const resources = [
-        TOOLS_GUIDE
-    ];
-    // Silent mode for MCP clients - only log to stderr in debug mode
-    if (process.env.DEBUG) {
-        logger.info(`Registered ${tools.length} Git tools`);
-        logger.info(`Registered ${resources.length} resource(s)`);
-        logger.info(`Registered ${GIT_PROMPTS.length} prompt(s)`);
-    }
-    // Create MCP Server with STDIO transport
-    const server = new Server({
-        name: '@andrebuzeli/git-mcp',
-        version: '10.0.6',
-    });
-    // Register tool list handler
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
-        logger.debug('Listing available tools');
-        return {
-            tools: tools.map(tool => ({
-                name: tool.name,
-                description: tool.description,
-                inputSchema: tool.inputSchema || {
-                    type: 'object',
-                    properties: {},
-                    additionalProperties: true,
-                },
-            })),
-        };
-    });
-    // Register tool execution handler with logging e segurança aprimorados
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const toolName = request.params.name;
-        const tool = tools.find(t => t.name === toolName);
-        const startTime = Date.now();
-        if (!tool) {
-            logSecurityEvent('TOOL_NOT_FOUND', { toolName });
-            throw new Error(`Tool not found: ${toolName}`);
-        }
-        try {
-            // Validar argumentos contra o schema da ferramenta
-            const args = request.params.arguments ?? {};
-            // Validação básica de segurança
-            if (typeof args !== 'object' || args === null) {
-                logSecurityEvent('INVALID_ARGUMENTS', { toolName, args });
-                throw new MCPError('VALIDATION_ERROR', 'Arguments must be an object');
-            }
-            // Validar projectPath se existir
-            if ('projectPath' in args) {
-                const projectPath = args.projectPath;
-                if (typeof projectPath !== 'string') {
-                    logSecurityEvent('INVALID_PROJECT_PATH_TYPE', { toolName, projectPath });
-                    throw new MCPError('VALIDATION_ERROR', 'projectPath must be a string');
-                }
-                if (!projectPath || projectPath.includes('..')) {
-                    logSecurityEvent('PATH_TRAVERSION_ATTEMPT', { toolName, projectPath });
-                    throw new MCPError('VALIDATION_ERROR', 'Invalid project path');
-                }
-            }
-            // Log da execução
-            logger.info(`Executing tool: ${toolName}`, { args }, toolName);
-            // Executar a ferramenta
-            const result = await tool.handle(args, { providerManager, gitAdapter });
-            const duration = Date.now() - startTime;
-            logPerformanceMetric(`tool_${toolName}`, duration, { success: true });
-            logToolExecution(toolName, args, result);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const duration = Date.now() - startTime;
-            logPerformanceMetric(`tool_${toolName}`, duration, { success: false, error: error.message });
-            logToolExecution(toolName, request.params.arguments ?? {}, undefined, error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Error: ${error.message || String(error)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
-    // Register resource list handler
-    server.setRequestHandler(ListResourcesRequestSchema, async () => {
-        logger.debug('Listing available resources');
-        return {
-            resources: resources.map(resource => ({
-                uri: resource.uri,
-                name: resource.name,
-                description: resource.description,
-                mimeType: resource.mimeType,
-            })),
-        };
-    });
-    // Register resource read handler
-    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-        const uri = request.params.uri;
-        const resource = resources.find(r => r.uri === uri);
-        if (!resource) {
-            logger.warn(`Resource not found: ${uri}`);
-            throw new Error(`Resource not found: ${uri}`);
-        }
-        logger.debug(`Reading resource: ${uri}`);
-        return {
-            contents: [
-                {
-                    uri: resource.uri,
-                    mimeType: resource.mimeType,
-                    text: resource.content,
-                },
-            ],
-        };
-    });
-    // Register prompt list handler
-    server.setRequestHandler(ListPromptsRequestSchema, async () => {
-        logger.debug('Listing available prompts');
-        return {
-            prompts: GIT_PROMPTS.map(prompt => ({
-                name: prompt.name,
-                description: prompt.description,
-                arguments: prompt.arguments,
-            })),
-        };
-    });
-    // Register prompt get handler
-    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-        const promptName = request.params.name;
-        const prompt = GIT_PROMPTS.find(p => p.name === promptName);
-        if (!prompt) {
-            logger.warn(`Prompt not found: ${promptName}`);
-            throw new Error(`Prompt not found: ${promptName}`);
-        }
-        logger.debug(`Generating prompt: ${promptName}`);
-        const result = await prompt.generate(request.params.arguments ?? {}, { providerManager, gitAdapter });
-        return {
-            description: result.description,
-            messages: result.messages,
-        };
-    });
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    // Only log in debug mode
-    if (process.env.DEBUG) {
-        logger.info(`✅ git-mcp MCP server running via STDIO`);
-        logger.info(`Tools: ${tools.length} registered`);
-        logger.info(`Resources: ${resources.length} registered`);
-        logger.info(`Prompts: ${GIT_PROMPTS.length} registered`);
-    }
-}
-main().catch(err => {
-    console.error('❌ Failed to start git-mcp:', err);
-    process.exit(1);
-});

package/dist/prompts/gitPrompts.d.ts

@@ -1,93 +0,0 @@
-import { MCPContext } from '../types.js';
-export interface Prompt {
-    name: string;
-    title?: string;
-    description?: string;
-    arguments?: Array<{
-        name: string;
-        description?: string;
-        required?: boolean;
-    }>;
-    generate(args: Record<string, any>, ctx: MCPContext): Promise<{
-        description?: string;
-        messages: Array<{
-            role: "user" | "assistant";
-            content: {
-                type: "text";
-                text: string;
-            };
-        }>;
-    }>;
-}
-/**
- * /gitupdate - Complete update workflow with remote traceability
- */
-export declare class GitUpdatePrompt implements Prompt {
-    name: string;
-    title: string;
-    description: string;
-    generate(args: Record<string, any>, ctx: MCPContext): Promise<{
-        description: string;
-        messages: {
-            role: "user";
-            content: {
-                type: "text";
-                text: string;
-            };
-        }[];
-    }>;
-} /**
- * /gitfix - Fix repository configuration
- */
-export declare class GitFixPrompt implements Prompt {
-    name: string;
-    title: string;
-    description: string;
-    generate(args: Record<string, any>, ctx: MCPContext): Promise<{
-        description: string;
-        messages: {
-            role: "user";
-            content: {
-                type: "text";
-                text: string;
-            };
-        }[];
-    }>;
-}
-/**
- * /gitlog - Generate changelog in repository
- */
-export declare class GitLogPrompt implements Prompt {
-    name: string;
-    title: string;
-    description: string;
-    generate(args: Record<string, any>, ctx: MCPContext): Promise<{
-        description: string;
-        messages: {
-            role: "user";
-            content: {
-                type: "text";
-                text: string;
-            };
-        }[];
-    }>;
-}
-/**
- * /gitrelease - Create release with changelog
- */
-export declare class GitReleasePrompt implements Prompt {
-    name: string;
-    title: string;
-    description: string;
-    generate(args: Record<string, any>, ctx: MCPContext): Promise<{
-        description: string;
-        messages: {
-            role: "user";
-            content: {
-                type: "text";
-                text: string;
-            };
-        }[];
-    }>;
-}
-export declare const GIT_PROMPTS: Prompt[];

package/dist/prompts/gitPrompts.js

@@ -1,177 +0,0 @@
-/**
- * /gitupdate - Complete update workflow with remote traceability
- */
-export class GitUpdatePrompt {
-    constructor() {
-        this.name = "gitupdate";
-        this.title = "Git Update - Complete Workflow";
-        this.description = "Execute complete Git update (add, commit, push) with full remote traceability via issues";
-    }
-    async generate(args, ctx) {
-        // PROMPT só instrui o AI AGENT - não detecta nada
-        // AI AGENT é responsável por detectar workspace e passar projectPath obrigatório
-        return {
-            description: "Git update workflow with remote traceability",
-            messages: [
-                {
-                    role: "user",
-                    content: {
-                        type: "text",
-                        text: `Execute the git-update tool to update the current project.
-
-You must call the git-update tool with:
-- projectPath: (REQUIRED) Detect the user's current workspace folder path
-- message: (optional) Generate appropriate conventional commit message
-- files: (optional) Default is ["."]
-
-The tool will automatically:
-1. Stage all changes
-2. Create commit
-3. Push to GitHub and Gitea
-4. Create traceability issues
-5. Return tracking report
-
-Call the tool now with the workspace path you detect from context.`
-                    }
-                }
-            ]
-        };
-    }
-} /**
- * /gitfix - Fix repository configuration
- */
-export class GitFixPrompt {
-    constructor() {
-        this.name = "gitfix";
-        this.title = "Git Fix - Repository Configuration";
-        this.description = "Automatically fix and configure Git repository for dual-provider system";
-    }
-    async generate(args, ctx) {
-        // PROMPT só instrui o AI AGENT - não detecta nada
-        return {
-            description: "Fix Git repository configuration",
-            messages: [
-                {
-                    role: "user",
-                    content: {
-                        type: "text",
-                        text: `Execute the git-fix tool to fix Git repository configuration.
-
-You must call the git-fix tool with:
-- projectPath: (REQUIRED) Detect the user's current workspace folder path
-- autoDetect: true (optional)
-
-The tool will automatically:
-1. Detect existing GitHub/Gitea remotes from URLs
-2. Remove broken/duplicate remotes
-3. Configure dual-provider setup (github, gitea, origin)
-4. Create .gitignore if missing
-5. Return configuration report
-
-Call the tool now with the workspace path you detect from context.`
-                    }
-                }
-            ]
-        };
-    }
-}
-/**
- * /gitlog - Generate changelog in repository
- */
-export class GitLogPrompt {
-    constructor() {
-        this.name = "gitlog";
-        this.title = "Git Log - Generate Changelog";
-        this.description = "Generate Keep a Changelog format changelog and commit it to the repository";
-    }
-    async generate(args, ctx) {
-        // PROMPT só instrui o AI AGENT - não detecta nada
-        return {
-            description: "Generate changelog in repository",
-            messages: [
-                {
-                    role: "user",
-                    content: {
-                        type: "text",
-                        text: `Execute the git-history tool to generate a changelog.
-
-You must call the git-history tool with:
-- projectPath: (REQUIRED) Detect the user's current workspace folder path
-- action: "generate_changelog" (REQUIRED)
-- outputFile: "CHANGELOG.md" (optional)
-- since: "last-tag" (optional)
-- format: "keepachangelog" (optional)
-
-The tool will automatically:
-1. Analyze commits since last tag
-2. Generate Keep a Changelog format
-3. Save to repository
-4. Commit and push
-
-Call the tool now with the workspace path you detect from context.`
-                    }
-                }
-            ]
-        };
-    }
-}
-/**
- * /gitrelease - Create release with changelog
- */
-export class GitReleasePrompt {
-    constructor() {
-        this.name = "gitrelease";
-        this.title = "Git Release - Create Release";
-        this.description = "Create new release with automatic or manual version and changelog (always uses force)";
-    }
-    async generate(args, ctx) {
-        // PROMPT só instrui o AI AGENT - não detecta nada
-        return {
-            description: "Create new release with changelog",
-            messages: [
-                {
-                    role: "user",
-                    content: {
-                        type: "text",
-                        text: `Execute the release workflow to create a new version.
-
-Workflow steps:
-
-1. Generate changelog using git-history tool:
-   - projectPath: (REQUIRED) Detect workspace
-   - action: "generate_changelog"
-
-2. Determine next version from commits (semver)
-
-3. Create tag using git-tags tool:
-   - projectPath: (REQUIRED) Detect workspace
-   - action: "create"
-   - tagName: Next version
-   - force: true
-
-4. Push tag using git-tags tool:
-   - projectPath: (REQUIRED) Detect workspace
-   - action: "push"
-   - tagName: Same version
-   - force: true
-
-5. Create releases using git-release tool:
-   - projectPath: (REQUIRED) Detect workspace
-   - action: "create"
-   - tagName: Same version
-   - body: Changelog content
-
-Execute all steps with the workspace path you detect from context.`
-                    }
-                }
-            ]
-        };
-    }
-}
-// Export all prompts
-export const GIT_PROMPTS = [
-    new GitUpdatePrompt(),
-    new GitFixPrompt(),
-    new GitLogPrompt(),
-    new GitReleasePrompt(),
-];

package/dist/providers/giteaProvider.d.ts

@@ -1,3 +0,0 @@
-export declare function createGiteaClient(baseUrl: string, token: string): {
-    request: (path: string, opts?: any) => Promise<import("axios").AxiosResponse<any, any, {}>>;
-};

package/dist/providers/giteaProvider.js

@@ -1,6 +0,0 @@
-import axios from 'axios';
-export function createGiteaClient(baseUrl, token) {
-    return {
-        request: (path, opts = {}) => axios.request({ url: `${baseUrl}${path}`, headers: { Authorization: `token ${token}` }, ...opts }),
-    };
-}

package/dist/providers/githubProvider.d.ts

@@ -1,2 +0,0 @@
-import { Octokit } from '@octokit/rest';
-export declare function createGitHubClient(token: string): Octokit;

package/dist/providers/githubProvider.js

@@ -1,4 +0,0 @@
-import { Octokit } from '@octokit/rest';
-export function createGitHubClient(token) {
-    return new Octokit({ auth: token });
-}

package/dist/providers/providerManager.d.ts

@@ -1,11 +0,0 @@
-import { Octokit } from '@octokit/rest';
-export declare class ProviderManager {
-    github?: Octokit;
-    giteaBaseUrl?: string;
-    giteaToken?: string;
-    constructor();
-    validateConfiguredProviders(): Promise<Record<string, {
-        ok: boolean;
-        error?: string;
-    }>>;
-}

package/dist/providers/providerManager.js

@@ -1,49 +0,0 @@
-import { Octokit } from '@octokit/rest';
-import axios from 'axios';
-export class ProviderManager {
-    constructor() {
-        const ghToken = process.env.GITHUB_TOKEN;
-        if (ghToken) {
-            this.github = new Octokit({ auth: ghToken });
-        }
-        if (process.env.GITEA_URL && process.env.GITEA_TOKEN) {
-            this.giteaBaseUrl = process.env.GITEA_URL;
-            this.giteaToken = process.env.GITEA_TOKEN;
-        }
-    }
-    async validateConfiguredProviders() {
-        const results = {};
-        const timeout = 5000; // 5 second timeout per provider
-        if (this.github) {
-            try {
-                const controller = new AbortController();
-                const timeoutId = setTimeout(() => controller.abort(), timeout);
-                await Promise.race([
-                    this.github.rest.users.getAuthenticated(),
-                    new Promise((_, reject) => setTimeout(() => reject(new Error('Timeout')), timeout))
-                ]);
-                clearTimeout(timeoutId);
-                results.github = { ok: true };
-            }
-            catch (err) {
-                results.github = { ok: false, error: err.message };
-            }
-        }
-        if (this.giteaBaseUrl && this.giteaToken) {
-            try {
-                const resp = await axios.get(`${this.giteaBaseUrl}/api/v1/user`, {
-                    headers: { Authorization: `token ${this.giteaToken}` },
-                    timeout: timeout,
-                });
-                if (resp.status === 200)
-                    results.gitea = { ok: true };
-                else
-                    results.gitea = { ok: false, error: `Status ${resp.status}` };
-            }
-            catch (err) {
-                results.gitea = { ok: false, error: err.message };
-            }
-        }
-        return results;
-    }
-}

package/dist/resources/toolsGuide.d.ts

@@ -1,12 +0,0 @@
-/**
- * Git-MCP Tools Guide Resource
- * Comprehensive documentation for all 20 Git tools available in the MCP server
- */
-export declare const TOOLS_GUIDE: {
-    uri: string;
-    name: string;
-    description: string;
-    mimeType: string;
-    content: string;
-};
-export default TOOLS_GUIDE;