@cyanheads/git-mcp-server 2.2.3 → 2.2.4

package/README.md

@@ -7,7 +7,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-^5.8.3-blue?style=flat-square)](https://www.typescriptlang.org/)
 [![Model Context Protocol SDK](https://img.shields.io/badge/MCP%20SDK-^1.17.0-green?style=flat-square)](https://github.com/modelcontextprotocol/typescript-sdk)
 [![MCP Spec Version](https://img.shields.io/badge/MCP%20Spec-2025--06--18-lightgrey?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/changelog.mdx)
-[![Version](https://img.shields.io/badge/Version-2.2.3-blue?style=flat-square)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/Version-2.2.4-blue?style=flat-square)](./CHANGELOG.md)
 [![Coverage](https://img.shields.io/badge/Coverage-0.0%25-red?style=flat-square)](./vitest.config.ts)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square)](https://opensource.org/licenses/Apache-2.0)
 [![Status](https://img.shields.io/badge/Status-Stable-green?style=flat-square)](https://github.com/cyanheads/git-mcp-server/issues)
@@ -182,6 +182,14 @@ See the current file tree in [docs/tree.md](docs/tree.md) or generate it dynamic
 npm run tree
 ```
 
+## 📦 Resources
+
+In addition to tools, the server provides resources that offer contextual information about the Git environment.
+
+| Resource URI              | Description                                                                                                |
+| :------------------------ | :--------------------------------------------------------------------------------------------------------- |
+| `git://working-directory` | Returns the currently configured working directory for the session as a JSON object. Shows `NOT_SET` if unset. |
+
 ## 🧩 Extending the System
 
 The canonical pattern for adding new tools is defined in the [.clinerules](.clinerules) file. It mandates a strict separation of concerns:

package/dist/mcp-server/resources/gitWorkingDir/index.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Barrel file for the git working directory resource.
+ * @module src/mcp-server/resources/gitWorkingDir/index
+ */
+export * from "./registration.js";

package/dist/mcp-server/resources/gitWorkingDir/logic.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Defines the core logic for the git working directory resource.
+ * @module src/mcp-server/resources/gitWorkingDir/logic
+ */
+import { logger } from "../../../utils/index.js";
+/**
+ * Retrieves the current working directory for the session.
+ * @param context The request context for logging and tracing.
+ * @param getWorkingDirectory Function to get the session's working directory.
+ * @param sessionId The ID of the current session.
+ * @returns The current working directory path or 'NOT_SET'.
+ */
+export function getGitWorkingDirLogic(context, getWorkingDirectory, sessionId) {
+    logger.debug("Executing getGitWorkingDirLogic...", { ...context, sessionId });
+    const workingDir = getWorkingDirectory(sessionId);
+    return workingDir ?? "NOT_SET";
+}

package/dist/mcp-server/resources/gitWorkingDir/registration.js

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Handles registration for the git working directory resource.
+ * @module src/mcp-server/resources/gitWorkingDir/registration
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { logger, requestContextService } from "../../../utils/index.js";
+import { getGitWorkingDirLogic } from "./logic.js";
+import { ErrorHandler } from "../../../utils/index.js";
+import { BaseErrorCode } from "../../../types-global/errors.js";
+const RESOURCE_URI = "git://working-directory";
+const RESOURCE_NAME = "git_working_directory";
+const RESOURCE_DESCRIPTION = "A resource that returns the currently configured working directory for the Git session as a JSON object. Returns 'NOT_SET' if no directory is configured.";
+/**
+ * Registers the Git Working Directory resource 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 registerGitWorkingDirResource = async (server, getWorkingDirectory, getSessionId) => {
+    const operation = "registerGitWorkingDirResource";
+    const context = requestContextService.createRequestContext({ operation });
+    await ErrorHandler.tryCatch(async () => {
+        const template = new ResourceTemplate(RESOURCE_URI, {
+            list: async () => ({ resources: [] }),
+        });
+        server.resource(RESOURCE_NAME, template, {
+            name: "Current Git Working Directory",
+            description: RESOURCE_DESCRIPTION,
+            mimeType: "application/json",
+        }, async (uri, params, callContext) => {
+            const handlerContext = requestContextService.createRequestContext({
+                parentRequestId: context.requestId,
+                operation: "HandleResourceRead",
+                resourceUri: uri.href,
+                inputParams: params,
+            });
+            try {
+                const sessionId = getSessionId(handlerContext);
+                const workingDir = getGitWorkingDirLogic(handlerContext, getWorkingDirectory, sessionId);
+                const responseData = { workingDirectory: workingDir };
+                return {
+                    contents: [{
+                            uri: uri.href,
+                            text: JSON.stringify(responseData),
+                            mimeType: "application/json",
+                        }],
+                };
+            }
+            catch (error) {
+                throw ErrorHandler.handleError(error, {
+                    operation: "gitWorkingDirReadHandler",
+                    context: handlerContext,
+                    input: { uri: uri.href, params },
+                });
+            }
+        });
+        logger.info(`Resource '${RESOURCE_NAME}' registered successfully.`, context);
+    }, {
+        operation: `RegisteringResource_${RESOURCE_NAME}`,
+        context: context,
+        errorCode: BaseErrorCode.INITIALIZATION_FAILED,
+        critical: true,
+    });
+};

package/dist/mcp-server/server.js

@@ -36,6 +36,8 @@ import { registerGitStatusTool } from "./tools/gitStatus/index.js";
 import { registerGitTagTool } from "./tools/gitTag/index.js";
 import { registerGitWorktreeTool } from "./tools/gitWorktree/index.js";
 import { registerGitWrapupInstructionsTool } from "./tools/gitWrapupInstructions/index.js";
+// Import registration functions for ALL resources
+import { registerGitWorkingDirResource } from "./resources/gitWorkingDir/index.js";
 // Import transport setup functions
 import { startHttpTransport } from "./transports/http/index.js";
 import { startStdioTransport } from "./transports/stdio/index.js";
@@ -103,6 +105,9 @@ async function createMcpServerInstance() {
         await registerGitWorktreeTool(server, getWorkingDirectory, getSessionIdFromContext);
         await registerGitWrapupInstructionsTool(server, getWorkingDirectory, getSessionIdFromContext);
         logger.info("Git tools registered successfully", context);
+        logger.debug("Registering Git resources...", context);
+        await registerGitWorkingDirResource(server, getWorkingDirectory, getSessionIdFromContext);
+        logger.info("Git resources registered successfully", context);
     }
     catch (err) {
         logger.error("Failed to register resources/tools", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/git-mcp-server",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "description": "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, and more, via the MCP standard. STDIO & HTTP.",
   "main": "dist/index.js",
   "files": [