@andrebuzeli/git-mcp 5.0.4 → 5.0.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Andre Buzeli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,134 +1,188 @@
-# MCP Git Production Server
+# GIT MCP Server
 
-Servidor MCP (Model Context Protocol) para operações Git profissionais com múltiplos providers (GitHub/Gitea), projetado para ambientes de produção com dados reais.
+Professional MCP (Model Context Protocol) server for Git operations with multi-provider support.
 
-## 🚀 Características
+## Features
 
-- **Produção Ready**: Apenas dados reais, sem modo demo
-- **Provider Obrigatório**: Controle explícito sobre onde operações são executadas
-- **Multi-provider**: Suporte simultâneo a GitHub e Gitea com parâmetro "both"
-- **Error Handling Avançado**: Mensagens detalhadas com guias de configuração
-- **Validação Robusta**: Validação completa de parâmetros e configuração
+- 🚀 **17 Specialized Git Tools** - Complete Git workflow coverage
+- 🔄 **Multi-Provider Support** - GitHub and Gitea simultaneously
+- � **Compatibilidade com IDEs/Clients** - Alguns clientes MCP ou IDEs esperam nomes alternativos para operações de arquivo (ex.: `listFiles`, `getFile`). O servidor mantém a universalidade oferecendo aliases compatíveis além das operações padrão `file-*`.
+- �🛡️ **Production Ready** - Robust validation and error handling
+- 📦 **NPM Distribution** - Easy installation via npx
+- 🤖 **AI Agent Integration** - Designed for AI agent workflows
 
-## 📦 Instalação
+## Quick Start
+
+### Installation & Usage
 
 ```bash
-npm install @andrebuzeli/gitea-mcp-v2
+# Run directly with npx (recommended)
+npx @andrebuzeli/git-mcp@latest
+
+# Or install globally
+npm install -g @andrebuzeli/git-mcp
+git-mcp
 ```
 
-## ⚙️ Configuração
+### Configuration
 
-**IMPORTANTE**: Configure pelo menos um provider para usar o sistema.
+Set up your provider credentials via environment variables:
 
-### GitHub
+#### GitHub Configuration
 ```bash
-GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-GITHUB_USERNAME=your-username  # opcional
+export GITHUB_TOKEN="your_github_token"
+export GITHUB_USERNAME="your_username"
 ```
 
-### Gitea
+#### Gitea Configuration
 ```bash
-GITEA_URL=https://your-gitea.com/api/v1
-GITEA_TOKEN=your_gitea_token_here
-GITEA_USERNAME=your-username  # opcional
+export GITEA_URL="https://your-gitea-instance.com"
+export GITEA_TOKEN="your_gitea_token"
+export GITEA_USERNAME="your_username"
 ```
 
-### Configuração de Ambos
-Para usar o parâmetro `provider: "both"`, configure ambos os providers acima.
-
-## 🛠️ Ferramentas Disponíveis
-
-### git-workflow (Workflow Principal)
-**Operações Locais** (sem provider):
-- `init`: Inicializar projeto completo
-- `commit`: Commit + push automático
-- `sync`: Pull + commit + push completo
-- `status`: Status detalhado do projeto
-- `backup`: Backup completo do projeto
-
-**Operações Remotas** (provider obrigatório):
-- `create`: Criar novo repositório
-- `list`: Listar repositórios
-- `get`: Obter detalhes do repositório
-- `update`: Atualizar repositório
-- `delete`: Remover repositório
-- `fork`: Criar fork
-- `search`: Buscar repositórios
-
-### git-files (Gerenciamento de Arquivos)
-- `read`: Ler conteúdo de arquivo
-- `create`: Criar novo arquivo
-- `update`: Atualizar arquivo existente
-- `delete`: Remover arquivo
-- `search`: Buscar conteúdo em arquivos
-- `backup`: Backup de arquivos
-
-## 🤖 Uso com Agentes IA
-
-### Operações Locais
-```typescript
-// Operações que não precisam de provider
+#### Multi-Provider Support
+Configure both GitHub and Gitea to use `provider="both"` in tool calls.
+
+## Available Tools
+
+| Tool | Description | Operations |
+|------|-------------|------------|
+| `git-workflow` | Core Git workflow operations | init, commit, sync, status, backup, create, list, get, update, delete, fork, search |
+| `git-files` | File management operations | read, create, update, delete, search, backup, list |
+| `git-branches` | Branch management | create, list, get, delete, merge, compare |
+| `git-issues` | Issue management | create, list, get, update, close, comment, search |
+| `git-pulls` | Pull request management | create, list, get, update, merge, close, review, search |
+| `git-tags` | Tag operations | create, list, get, delete, search |
+| `git-release` | Release management | create, list, get, update, delete, publish, download |
+| `git-remote` | Remote operations | add, remove, rename, show, set-url, prune |
+| `git-reset` | Reset operations | soft, mixed, hard, reset-to-commit, reset-branch |
+| `git-stash` | Stash management | stash, pop, apply, list, show, drop, clear |
+| `git-config` | Git configuration | get, set, unset, list, edit, show |
+| `git-monitor` | Monitoring and logs | log, status, commits, contributors |
+| `git-backup` | Backup system | backup, restore, list, verify |
+| `git-archive` | Archive operations | create, extract, list, verify |
+| `git-packages` | Package management | list, get, create, update, delete, publish, download |
+| `git-analytics` | Analytics and stats | stats, commits, contributors |
+| `git-sync` | Advanced synchronization | sync, status |
+
+## Usage Examples
+
+### Basic Git Operations
+
+```json
 {
-  "action": "init",
-  "projectPath": "/path/to/project"
+  "name": "git-workflow",
+  "arguments": {
+    "action": "init",
+    "projectPath": "/path/to/project"
+  }
 }
 ```
 
-### Operações Remotas (Provider Obrigatório)
-```typescript
-// GitHub apenas
+### Remote Repository Operations
+
+```json
 {
-  "action": "create",
-  "projectPath": "/path/to/project",
-  "provider": "github",
-  "repoName": "my-repo"
+  "name": "git-workflow",
+  "arguments": {
+    "action": "create",
+    "projectPath": "/path/to/project",
+    "provider": "github",
+    "name": "my-new-repo",
+    "description": "My new repository",
+    "private": false
+  }
 }
+```
+
+### Multi-Provider Operations
 
-// Gitea apenas
+```json
 {
-  "action": "list",
-  "projectPath": "/path/to/project",
-  "provider": "gitea"
+  "name": "git-issues",
+  "arguments": {
+    "action": "create",
+    "projectPath": "/path/to/project",
+    "provider": "both",
+    "title": "Bug Report",
+    "body": "Description of the issue"
+  }
 }
+```
+
+### File Management
 
-// Ambos simultaneamente
+```json
 {
-  "action": "create",
-  "projectPath": "/path/to/project",
-  "provider": "both",
-  "repoName": "my-repo"
+  "name": "git-files",
+  "arguments": {
+    "action": "create",
+    "projectPath": "/path/to/project",
+    "provider": "github",
+    "path": "src/new-file.js",
+    "content": "console.log('Hello World');",
+    "message": "Add new file"
+  }
 }
 ```
 
-### Valores de Provider
-- `"github"`: Executa apenas no GitHub
-- `"gitea"`: Executa apenas no Gitea  
-- `"both"`: Executa em ambos simultaneamente
+## MCP Resources
+
+- `mcp-git://status` - Server status and configuration
+- `mcp-git://tools` - List of available tools with detailed information
+
+## Error Handling
+
+The server provides comprehensive error handling with:
 
-## 🏗️ Arquitetura
+- **Detailed Error Messages** - Clear descriptions of what went wrong
+- **Configuration Guidance** - Instructions for missing setup
+- **Validation Errors** - Specific parameter validation feedback
+- **Troubleshooting Tips** - Actionable suggestions for resolution
 
-- **BaseProvider**: Interface unificada para todos os VCS
-- **AutoDetection**: Sistema de descoberta automática
-- **UniversalErrorHandler**: Tratamento padronizado de erros
-- **UniversalResponse**: Formato padronizado de resposta
+## Requirements
 
-## 📋 Desenvolvimento
+- **Node.js** 18.0.0 or higher
+- **Git** installed and accessible in PATH
+- **Provider Credentials** (GitHub token, Gitea token) for remote operations
+
+## Development
+
+### Local Development
 
 ```bash
-# Instalar dependências
+# Clone the repository
+git clone https://github.com/andrebuzeli/git-mcp.git
+cd git-mcp
+
+# Install dependencies
 npm install
 
-# Build
+# Build the project
 npm run build
 
-# Desenvolvimento
+# Run locally
+npm start
+
+# Development mode with auto-reload
 npm run dev
 ```
 
-## 📝 Licença
+### Testing
+
+```bash
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+## License
 
-MIT
+MIT License - see [LICENSE](LICENSE) file for details.
 
-## 🤝 Contribuição
+## Contributing
 
-Contribuições são bem-vindas! Este projeto foi desenvolvido especificamente para integração com agentes de IA.
+Contributions are welcome! Please read our contributing guidelines and submit pull requests.

package/dist/config.d.ts

@@ -1,77 +1,78 @@
-import { z } from 'zod';
 /**
- * Schema de validação para configuração do servidor MCP Git
+ * Configuration Management
+ *
+ * Handles environment variable configuration for GitHub and Gitea providers.
+ * Provides validation and auto-detection utilities.
  */
-declare const ConfigSchema: z.ZodObject<{
-    giteaUrl: z.ZodOptional<z.ZodString>;
-    giteaToken: z.ZodOptional<z.ZodString>;
-    giteaUsername: z.ZodOptional<z.ZodString>;
-    githubToken: z.ZodOptional<z.ZodString>;
-    githubUsername: z.ZodOptional<z.ZodString>;
-    provider: z.ZodOptional<z.ZodEnum<["gitea", "github"]>>;
-    apiUrl: z.ZodOptional<z.ZodString>;
-    apiToken: z.ZodOptional<z.ZodString>;
-    defaultProvider: z.ZodOptional<z.ZodString>;
-    providersJson: z.ZodEffects<z.ZodOptional<z.ZodString>, any, string | undefined>;
-    debug: z.ZodDefault<z.ZodBoolean>;
-    timeout: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    debug: boolean;
-    timeout: number;
-    giteaUrl?: string | undefined;
-    giteaToken?: string | undefined;
-    giteaUsername?: string | undefined;
-    githubToken?: string | undefined;
-    githubUsername?: string | undefined;
-    provider?: "gitea" | "github" | undefined;
-    apiUrl?: string | undefined;
-    apiToken?: string | undefined;
-    defaultProvider?: string | undefined;
-    providersJson?: any;
-}, {
-    giteaUrl?: string | undefined;
-    giteaToken?: string | undefined;
-    giteaUsername?: string | undefined;
-    githubToken?: string | undefined;
-    githubUsername?: string | undefined;
-    provider?: "gitea" | "github" | undefined;
-    apiUrl?: string | undefined;
-    apiToken?: string | undefined;
-    defaultProvider?: string | undefined;
-    providersJson?: string | undefined;
-    debug?: boolean | undefined;
-    timeout?: number | undefined;
-}>;
-type Config = z.infer<typeof ConfigSchema>;
-/**
- * Gerenciador de configuração usando padrão Singleton
- */
-declare class ConfigManager {
-    private static instance;
+export interface GitMCPConfig {
+    github?: {
+        token: string;
+        username: string;
+    };
+    gitea?: {
+        url: string;
+        token: string;
+        username: string;
+    };
+}
+export interface ProjectContext {
+    projectPath: string;
+    repositoryName: string;
+    isGitRepository: boolean;
+    remoteOrigin?: string;
+    currentBranch?: string;
+    detectedProvider?: string;
+}
+export interface ConfigValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    missingEnvVars: string[];
+    configurationGuide?: {
+        requiredEnvVars: string[];
+        exampleConfig: Record<string, string>;
+    };
+}
+export declare class ConfigManager {
     private config;
     constructor();
-    static getInstance(): ConfigManager;
-    private loadConfig;
-    getConfig(): Config;
-    getGiteaUrl(): string | undefined;
-    getGiteaToken(): string | undefined;
-    getGiteaUsername(): string | undefined;
-    isDebug(): boolean;
-    getTimeout(): number;
-    getProvider(): 'gitea' | 'github' | undefined;
-    getApiUrl(): string | undefined;
-    getApiToken(): string | undefined;
-    getGitHubToken(): string | undefined;
-    getGitHubUsername(): string | undefined;
-    getDefaultProvider(): string | undefined;
-    getProvidersJson(): any;
-    isMultiProvider(): boolean;
-    isGenericConfig(): boolean;
-    isLegacyGitea(): boolean;
+    private loadConfiguration;
+    getConfig(): GitMCPConfig;
+    isGitHubConfigured(): boolean;
+    isGiteaConfigured(): boolean;
+    getConfigurationStatus(): Record<string, string>;
+    /**
+     * Validates GitHub and Gitea credentials
+     */
+    validateCredentials(): ConfigValidationResult;
+    /**
+     * Auto-detects project context from projectPath
+     */
+    detectProjectContext(projectPath: string): ProjectContext;
+    /**
+     * Auto-detects username/owner from environment variables
+     */
+    autoDetectUsername(provider: 'github' | 'gitea'): string | undefined;
+    /**
+     * Gets provider configuration for a specific provider
+     */
+    getProviderConfig(provider: 'github' | 'gitea'): {
+        token: string;
+        username: string;
+    } | undefined;
+    /**
+     * Checks if a provider is supported for operations
+     */
+    isProviderSupported(provider: 'github' | 'gitea' | 'both'): boolean;
+    /**
+     * Gets configuration guidance for missing setup
+     */
+    getConfigurationGuidance(): {
+        requiredEnvVars: string[];
+        exampleConfig: Record<string, string>;
+        setupInstructions: string[];
+    };
 }
-/**
- * Instância global do ConfigManager
- */
-export declare const config: ConfigManager;
-export {};
+export declare const configManager: ConfigManager;
+export declare function getProviderConfig(): GitMCPConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgChB,CAAC;AAEH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3C;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAS;;IAMvB,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC,OAAO,CAAC,UAAU;IA6DlB,SAAS,IAAI,MAAM;IAInB,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,OAAO,IAAI,OAAO;IAIlB,UAAU,IAAI,MAAM;IAIpB,WAAW,IAAI,OAAO,GAAG,QAAQ,GAAG,SAAS;IAI7C,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAIxC,gBAAgB,IAAI,GAAG;IAIvB,eAAe,IAAI,OAAO;IAI1B,eAAe,IAAI,OAAO;IAI1B,aAAa,IAAI,OAAO;CAKzB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,eAA8B,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE;QACnB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAAC;CACH;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;;IAM7B,OAAO,CAAC,iBAAiB;IAuBlB,SAAS,IAAI,YAAY;IAIzB,kBAAkB,IAAI,OAAO;IAI7B,iBAAiB,IAAI,OAAO;IAI5B,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOvD;;OAEG;IACI,mBAAmB,IAAI,sBAAsB;IA2DpD;;OAEG;IACI,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAgDhE;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS;IAU3E;;OAEG;IACI,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;eAhN5C,MAAM;kBACH,MAAM;;IAmNlB;;OAEG;IACI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO;IAO1E;;OAEG;IACI,wBAAwB,IAAI;QACjC,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B;CAqBF;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD"}