@andrebuzeli/git-mcp 6.1.1 → 6.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -4,7 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
4
4
  return (mod && mod.__esModule) ? mod : { "default": mod };
5
5
  };
6
6
  Object.defineProperty(exports, "__esModule", { value: true });
7
- const server_1 = require("./server");
7
+ const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
8
+ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
9
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
8
10
  const providerManager_1 = require("./providers/providerManager");
9
11
  const config_1 = require("./config");
10
12
  const gitFiles_1 = require("./tools/gitFiles");
@@ -70,59 +72,92 @@ async function main() {
70
72
  console.error(`Registered ${tools.length} Git tools`);
71
73
  console.error(`Registered ${resources.length} resource(s)`);
72
74
  }
73
- const app = (0, server_1.createServer)({ tools, providerManager, resources });
74
- // Try default port, then find available port if occupied
75
- let port = parseInt(process.env.PORT || '3210');
76
- const startServer = (attemptPort) => {
77
- return new Promise((resolve, reject) => {
78
- const server = app.listen(attemptPort, () => {
79
- // Send success message to stderr (MCP clients expect JSON on stdout)
80
- if (process.env.DEBUG) {
81
- console.error(`✅ git-mcp server ready on http://localhost:${attemptPort}`);
82
- console.error(`Tools: ${tools.map(t => t.name).join(', ')}`);
83
- console.error(`Resources: ${resources.map(r => r.uri).join(', ')}`);
84
- }
85
- resolve(server);
86
- });
87
- server.on('error', (err) => {
88
- if (err.code === 'EADDRINUSE') {
89
- // Port in use, try next port
90
- server.close();
91
- resolve(null);
92
- }
93
- else {
94
- reject(err);
95
- }
96
- });
97
- });
98
- };
99
- // Try to start server on available port
100
- let server = null;
101
- const maxAttempts = 10;
102
- for (let attempt = 0; attempt < maxAttempts; attempt++) {
103
- const tryPort = port + attempt;
104
- server = await startServer(tryPort);
105
- if (server) {
106
- port = tryPort;
107
- break;
75
+ // Create MCP Server with STDIO transport
76
+ const server = new index_js_1.Server({
77
+ name: '@andrebuzeli/git-mcp',
78
+ version: '6.2.1',
79
+ });
80
+ // Register tool list handler
81
+ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
82
+ return {
83
+ tools: tools.map(tool => ({
84
+ name: tool.name,
85
+ description: tool.description,
86
+ inputSchema: {
87
+ type: 'object',
88
+ properties: {},
89
+ additionalProperties: true,
90
+ },
91
+ })),
92
+ };
93
+ });
94
+ // Register tool execution handler
95
+ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
96
+ const toolName = request.params.name;
97
+ const tool = tools.find(t => t.name === toolName);
98
+ if (!tool) {
99
+ throw new Error(`Tool not found: ${toolName}`);
108
100
  }
109
- }
110
- if (!server) {
111
- console.error(`❌ Failed to find available port after ${maxAttempts} attempts`);
112
- process.exit(1);
113
- }
114
- server.on('error', (err) => {
115
- console.error(' Server error:', err);
116
- process.exit(1);
101
+ try {
102
+ const result = await tool.handle(request.params.arguments ?? {}, { providerManager });
103
+ return {
104
+ content: [
105
+ {
106
+ type: 'text',
107
+ text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
108
+ },
109
+ ],
110
+ };
111
+ }
112
+ catch (error) {
113
+ return {
114
+ content: [
115
+ {
116
+ type: 'text',
117
+ text: `Error: ${error.message || String(error)}`,
118
+ },
119
+ ],
120
+ isError: true,
121
+ };
122
+ }
123
+ });
124
+ // Register resource list handler
125
+ server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => {
126
+ return {
127
+ resources: resources.map(resource => ({
128
+ uri: resource.uri,
129
+ name: resource.name,
130
+ description: resource.description,
131
+ mimeType: resource.mimeType,
132
+ })),
133
+ };
117
134
  });
118
- // Keep process alive
119
- process.on('SIGINT', () => {
120
- console.log('\n👋 Shutting down server...');
121
- server.close(() => {
122
- console.log('Server closed');
123
- process.exit(0);
124
- });
135
+ // Register resource read handler
136
+ server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
137
+ const uri = request.params.uri;
138
+ const resource = resources.find(r => r.uri === uri);
139
+ if (!resource) {
140
+ throw new Error(`Resource not found: ${uri}`);
141
+ }
142
+ return {
143
+ contents: [
144
+ {
145
+ uri: resource.uri,
146
+ mimeType: resource.mimeType,
147
+ text: resource.content,
148
+ },
149
+ ],
150
+ };
125
151
  });
152
+ // Start server with STDIO transport
153
+ const transport = new stdio_js_1.StdioServerTransport();
154
+ await server.connect(transport);
155
+ // Only log in debug mode
156
+ if (process.env.DEBUG) {
157
+ console.error(`✅ git-mcp MCP server running via STDIO`);
158
+ console.error(`Tools: ${tools.length} registered`);
159
+ console.error(`Resources: ${resources.length} registered`);
160
+ }
126
161
  }
127
162
  main().catch(err => {
128
163
  console.error('❌ Failed to start git-mcp:', err);
@@ -8,7 +8,6 @@ export declare class GitBranchesTool implements Tool {
8
8
  branches?: undefined;
9
9
  current?: undefined;
10
10
  deleted?: undefined;
11
- currentBranch?: undefined;
12
11
  result?: undefined;
13
12
  baseBranch?: undefined;
14
13
  compareBranch?: undefined;
@@ -20,7 +19,6 @@ export declare class GitBranchesTool implements Tool {
20
19
  success?: undefined;
21
20
  branch?: undefined;
22
21
  deleted?: undefined;
23
- currentBranch?: undefined;
24
22
  result?: undefined;
25
23
  baseBranch?: undefined;
26
24
  compareBranch?: undefined;
@@ -32,7 +30,6 @@ export declare class GitBranchesTool implements Tool {
32
30
  current: boolean;
33
31
  branches?: undefined;
34
32
  deleted?: undefined;
35
- currentBranch?: undefined;
36
33
  result?: undefined;
37
34
  baseBranch?: undefined;
38
35
  compareBranch?: undefined;
@@ -41,7 +38,6 @@ export declare class GitBranchesTool implements Tool {
41
38
  } | {
42
39
  success: boolean;
43
40
  deleted: any;
44
- currentBranch: string;
45
41
  branch?: undefined;
46
42
  branches?: undefined;
47
43
  current?: undefined;
@@ -57,7 +53,6 @@ export declare class GitBranchesTool implements Tool {
57
53
  branches?: undefined;
58
54
  current?: undefined;
59
55
  deleted?: undefined;
60
- currentBranch?: undefined;
61
56
  baseBranch?: undefined;
62
57
  compareBranch?: undefined;
63
58
  commits?: undefined;
@@ -72,7 +67,6 @@ export declare class GitBranchesTool implements Tool {
72
67
  branches?: undefined;
73
68
  current?: undefined;
74
69
  deleted?: undefined;
75
- currentBranch?: undefined;
76
70
  result?: undefined;
77
71
  }>;
78
72
  }
@@ -7,7 +7,6 @@ exports.GitBranchesTool = void 0;
7
7
  const simple_git_1 = __importDefault(require("simple-git"));
8
8
  const errors_1 = require("../utils/errors");
9
9
  const safetyController_1 = require("../utils/safetyController");
10
- const repoHelpers_1 = require("../utils/repoHelpers");
11
10
  class GitBranchesTool {
12
11
  constructor() {
13
12
  this.name = 'git-branches';
@@ -61,17 +60,8 @@ class GitBranchesTool {
61
60
  const branchName = params.branchName;
62
61
  if (!branchName)
63
62
  throw new errors_1.MCPError('VALIDATION_ERROR', 'branchName is required');
64
- // Safety check: prevent deleting the current active branch
65
- const currentBranch = (0, repoHelpers_1.getCurrentBranch)(projectPath);
66
- if (currentBranch && currentBranch === branchName) {
67
- throw new errors_1.MCPError('SAFETY_ERROR', `Cannot delete the currently active branch '${branchName}'.`, [
68
- 'Switch to another branch first using git checkout',
69
- 'Example: git checkout master',
70
- 'Then retry the delete operation',
71
- ]);
72
- }
73
63
  await git.deleteLocalBranch(branchName, params.force);
74
- return { success: true, deleted: branchName, currentBranch };
64
+ return { success: true, deleted: branchName };
75
65
  }
76
66
  case 'merge': {
77
67
  const branchName = params.branchName;
@@ -6,7 +6,6 @@ export declare class GitSyncTool implements Tool {
6
6
  success: boolean;
7
7
  remote: any;
8
8
  branch: any;
9
- automated: boolean;
10
9
  message: string;
11
10
  status?: undefined;
12
11
  remotes?: undefined;
@@ -21,7 +20,6 @@ export declare class GitSyncTool implements Tool {
21
20
  remotes: import("simple-git").RemoteWithRefs[];
22
21
  remote?: undefined;
23
22
  branch?: undefined;
24
- automated?: undefined;
25
23
  message?: undefined;
26
24
  }>;
27
25
  }
@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.GitSyncTool = void 0;
7
7
  const simple_git_1 = __importDefault(require("simple-git"));
8
8
  const errors_1 = require("../utils/errors");
9
- const repoHelpers_1 = require("../utils/repoHelpers");
10
9
  class GitSyncTool {
11
10
  constructor() {
12
11
  this.name = 'git-sync';
@@ -22,20 +21,13 @@ class GitSyncTool {
22
21
  switch (action) {
23
22
  case 'sync': {
24
23
  const remote = params.remote || 'origin';
25
- // Auto-detect current branch if not provided
26
- let branch = params.branch;
27
- if (!branch) {
28
- branch = (0, repoHelpers_1.getCurrentBranch)(projectPath);
29
- if (!branch) {
30
- throw new errors_1.MCPError('VALIDATION_ERROR', 'Could not detect current branch. Please provide branch parameter.');
31
- }
32
- }
24
+ const branch = params.branch;
33
25
  if (branch) {
34
26
  await git.checkout(branch);
35
27
  }
36
28
  await git.fetch(remote);
37
29
  await git.pull(remote, branch);
38
- return { success: true, remote, branch, automated: !params.branch, message: 'Repository synced' };
30
+ return { success: true, remote, branch, message: 'Repository synced' };
39
31
  }
40
32
  case 'status': {
41
33
  const status = await git.status();
@@ -60,14 +60,7 @@ class GitUploadTool {
60
60
  const repoName = params.repoName || (0, repoHelpers_1.getRepoNameFromPath)(projectPath);
61
61
  const description = params.description || `Project uploaded via git-upload at ${new Date().toISOString()}`;
62
62
  const isPrivate = params.private !== undefined ? params.private : true;
63
- // Auto-detect current branch if not provided
64
- let branch = params.branch;
65
- if (!branch) {
66
- branch = (0, repoHelpers_1.getCurrentBranch)(projectPath);
67
- if (!branch) {
68
- branch = 'master'; // Ultimate fallback
69
- }
70
- }
63
+ const branch = params.branch || 'master';
71
64
  const git = (0, simple_git_1.default)({ baseDir: projectPath });
72
65
  // Resultado com rastreabilidade completa
73
66
  const results = {
@@ -6,16 +6,6 @@
6
6
  * Normalizes: spaces to hyphens, lowercase, keeps alphanumeric and hyphens/underscores
7
7
  */
8
8
  export declare function getRepoNameFromPath(projectPath: string): string;
9
- /**
10
- * Get current Git branch from project path
11
- * Returns empty string if not in a Git repository
12
- */
13
- export declare function getCurrentBranch(projectPath: string): string;
14
- /**
15
- * Get default branch from Git repository (usually 'main' or 'master')
16
- * Falls back to 'master' if unable to determine
17
- */
18
- export declare function getDefaultBranch(projectPath: string): string;
19
9
  /**
20
10
  * Get GitHub owner from environment
21
11
  */
@@ -4,8 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.getRepoNameFromPath = getRepoNameFromPath;
7
- exports.getCurrentBranch = getCurrentBranch;
8
- exports.getDefaultBranch = getDefaultBranch;
9
7
  exports.getGitHubOwner = getGitHubOwner;
10
8
  exports.getGiteaOwner = getGiteaOwner;
11
9
  exports.getGiteaUrl = getGiteaUrl;
@@ -13,7 +11,6 @@ exports.buildGitHubUrl = buildGitHubUrl;
13
11
  exports.buildGiteaUrl = buildGiteaUrl;
14
12
  exports.getRepoInfo = getRepoInfo;
15
13
  const path_1 = __importDefault(require("path"));
16
- const child_process_1 = require("child_process");
17
14
  /**
18
15
  * Helper functions to extract repository information automatically
19
16
  */
@@ -27,55 +24,6 @@ function getRepoNameFromPath(projectPath) {
27
24
  .replace(/\s+/g, '-')
28
25
  .replace(/[^a-z0-9-_]/g, '');
29
26
  }
30
- /**
31
- * Get current Git branch from project path
32
- * Returns empty string if not in a Git repository
33
- */
34
- function getCurrentBranch(projectPath) {
35
- try {
36
- const branchName = (0, child_process_1.execSync)('git rev-parse --abbrev-ref HEAD', {
37
- cwd: projectPath,
38
- encoding: 'utf8',
39
- stdio: ['pipe', 'pipe', 'ignore'], // Suppress stderr
40
- });
41
- return branchName.trim();
42
- }
43
- catch (error) {
44
- return '';
45
- }
46
- }
47
- /**
48
- * Get default branch from Git repository (usually 'main' or 'master')
49
- * Falls back to 'master' if unable to determine
50
- */
51
- function getDefaultBranch(projectPath) {
52
- try {
53
- // Try to get default branch from remote
54
- const defaultBranch = (0, child_process_1.execSync)('git symbolic-ref refs/remotes/origin/HEAD', {
55
- cwd: projectPath,
56
- encoding: 'utf8',
57
- stdio: ['pipe', 'pipe', 'ignore'],
58
- });
59
- return defaultBranch.trim().replace('refs/remotes/origin/', '');
60
- }
61
- catch (error) {
62
- // If that fails, try to detect main or master
63
- try {
64
- const branches = (0, child_process_1.execSync)('git branch -r', {
65
- cwd: projectPath,
66
- encoding: 'utf8',
67
- stdio: ['pipe', 'pipe', 'ignore'],
68
- });
69
- if (branches.includes('origin/main'))
70
- return 'main';
71
- if (branches.includes('origin/master'))
72
- return 'master';
73
- }
74
- catch { }
75
- // Ultimate fallback
76
- return 'master';
77
- }
78
- }
79
27
  /**
80
28
  * Get GitHub owner from environment
81
29
  */
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@andrebuzeli/git-mcp",
3
- "version": "6.1.1",
4
- "description": "Professional MCP server for Git operations - FULLY AUTONOMOUS: auto-detects current branch, default branch, owner from env, repo from path. Zero manual parameters. Intelligent defaults for all operations. Dual-provider execution (GitHub + Gitea)",
3
+ "version": "6.2.1",
4
+ "description": "Professional MCP server for Git operations - STDIO UNIVERSAL: works in ANY IDE (Cursor, VSCode, Claude Desktop). Fully autonomous with intelligent error handling. Auto-detects branches, owner, repo. User-friendly error messages. Dual-provider execution (GitHub + Gitea)",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
7
7
  "bin": {