git-mob-mcp-server 1.0.7 → 1.0.9

package/README.md

@@ -14,35 +14,31 @@ Built using [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/
 - Setup git mob CLI globally or locally
 - Add / delete / list team members
 - Choose team members for pairing / mobbing session
-- Automatic appending of Co-authored-by  in for co-authors in commit messages during pairing / mobbing session
+- Automatic appending of Co-authored-by in for co-authors in commit messages during pairing / mobbing session
 
 ## API
 
 ### Resources
-- `git_mob_help`: Displays general help and usage information for the Git Mob CLI.
+
+- `git_mob_help`: General help and usage information for the Git Mob CLI.
 - `git_mob_version`: The installed version of the Git Mob CLI.
-- `team_members`: List of all the team members that have been added to Git Mob.
-- `mob_session_coauthors`: List of all coauthors currently included in the active mob or pairing session.
-- `mob_session_coauthors` (trailers): List of the git Co-authored-by trailers for the coauthors currently included in the active mob or pairing session.
 
 ### Tools
+
+- `git_mob_help`: Displays general help and usage information for the Git Mob CLI.
+- `setup_git_mob_globally`: Sets up git-mob globally for the user.
+- `setup_git_mob_locally`: Sets up git-mob locally for the current repository.
 - `add_team_member`: Adds a new team member using their key, name, and email.
-- `clear_mob_session`: Clears the active mob or pairing session.
 - `delete_team_member`: Deletes a team member by their key.
+- `list_team_members`: Lists all team members that have been added to Git Mob.
 - `set_mob_session_coauthors`: Sets the active pairing or mob session by specifying the keys of the team members to include as coauthors.
-- `setup_git_mob_globally`: Sets up git-mob globally for the user.
-- `setup_git_mob_locally`: Sets up git-mob locally for the current repository.
-
-Because resources may not be fully supported in GitHub Copilot Agent mode yet, all resources also available as tools:
-- `git_mob_help`: Displays general help and usage information for the Git Mob CLI.
-- `get_git_mob_version`: The installed version of the Git Mob CLI.
-- `get_team_members`: List of all the team members that have been added to Git Mob.
-- `get_mob_session_coauthors`: List of all coauthors currently included in the active mob or pairing session.
-- `get_mob_session_coauthors` (trailers): List of the git Co-authored-by trailers for the coauthors currently included in the active mob or pairing session.
+- `clear_mob_session`: Clears the active mob or pairing session.
+- `list_mob_session_coauthors`: Lists all coauthors currently included in the active mob or pairing session.
+- `list_mob_session_coauthors` (trailers): Lists the git Co-authored-by trailers for the coauthors currently included in the active mob or pairing session.
 
 ## Usage with Claude Desktop
-Add this to your `claude_desktop_config.json`:
 
+Add this to your `claude_desktop_config.json`:
 
 ### NPX
 
@@ -51,10 +47,7 @@ Add this to your `claude_desktop_config.json`:
   "mcpServers": {
     "git-mob": {
       "command": "npx",
-      "args": [
-        "-y",
-        "git-mob-mcp-server"
-      ]
+      "args": ["-y", "git-mob-mcp-server"]
     }
   }
 }
@@ -76,10 +69,7 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
     "servers": {
       "git-mob": {
         "command": "npx",
-        "args": [
-          "-y",
-          "git-mob-mcp-server",
-        ]
+        "args": ["-y", "git-mob-mcp-server"]
       }
     }
   }
@@ -88,4 +78,4 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
 
 ## License
 
-This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
+This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

package/dist/gitMobServerFactory.js

@@ -2,7 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import * as tools from "./tools/index.js";
 import * as resources from "./resources/index.js";
 import * as resourceTemplates from "./resourceTemplates/index.js";
-import { registerGitMobTool, registerGitMobResource, registerGtMobResourceAsTool, registerGitMobResourceTemplate, } from "./helpers/index.js";
+import { registerGitMobTool, registerGitMobResource, registerGitMobResourceTemplate, } from "./helpers/index.js";
 export const createGitMobServer = () => {
     const server = new McpServer({
         name: "Git Mob",
@@ -15,20 +15,15 @@ export const createGitMobServer = () => {
     });
     registerGitMobResourceTemplate(server, resourceTemplates.gitMobHelp);
     registerGitMobResource(server, resources.gitMobVersion);
-    registerGitMobResource(server, resources.teamMembers);
-    registerGitMobResource(server, resources.mobSessionCoauthors);
-    registerGitMobResource(server, resources.mobSessionCoauthorTrailers);
-    // Currently, Github Copilot does not support dynamic resources in MCP Server,
-    // so we register them as tools as well
-    registerGtMobResourceAsTool(server, resources.gitMobVersion);
-    registerGtMobResourceAsTool(server, resources.teamMembers);
-    registerGtMobResourceAsTool(server, resources.mobSessionCoauthors);
-    registerGtMobResourceAsTool(server, resources.mobSessionCoauthorTrailers);
+    registerGitMobTool(server, tools.getGitMobHelp);
     registerGitMobTool(server, tools.setupGitMobGlobally);
     registerGitMobTool(server, tools.setupGitMobLocally);
     registerGitMobTool(server, tools.addTeamMember);
     registerGitMobTool(server, tools.deleteTeamMember);
+    registerGitMobTool(server, tools.listTeamMembers);
     registerGitMobTool(server, tools.setMobSessionCoauthors);
     registerGitMobTool(server, tools.clearMobSession);
+    registerGitMobTool(server, tools.listMobSessionCoauthors);
+    registerGitMobTool(server, tools.listMobSessionCoauthorTrailers);
     return server;
 };

package/dist/helpers/index.js

@@ -1,5 +1,4 @@
 export * from "./registerGitMobTool.js";
 export * from "./registerGitMobResource.js";
 export * from "./registerGitMobResourceTemplate.js";
-export * from "./registerGitMobResourceAsTool.js";
 export * from "./runCliCommand.js";

package/dist/resourceTemplates/gitMobHelp.js

@@ -9,7 +9,7 @@ const template = new ResourceTemplate(new UriTemplate("gitmob://help{?command}")
     },
 });
 const metadata = {
-    description: "Displays general help and usage information for the Git Mob CLI. " +
+    description: "General help and usage information for the Git Mob CLI. " +
         "You can optionally provide a command ('setup', 'coauthor', or 'help') " +
         "to get detailed help for that specific command.",
     mimeType: "text/plain",

package/dist/resources/index.js

@@ -1,4 +1 @@
 export { default as gitMobVersion } from "./gitMobVersion.js";
-export { default as teamMembers } from "./teamMembers.js";
-export { default as mobSessionCoauthors } from "./mobSessionCoauthors.js";
-export { default as mobSessionCoauthorTrailers } from "./mobSessionCoauthorTrailers.js";

package/dist/tools/index.js

@@ -1,6 +1,10 @@
+export { default as getGitMobHelp } from "./getGitMobHelp.js";
 export { default as setupGitMobGlobally } from "./setupGitMobGlobally.js";
 export { default as setupGitMobLocally } from "./setupGitMobLocally.js";
 export { default as addTeamMember } from "./addTeamMember.js";
 export { default as deleteTeamMember } from "./deleteTeamMember.js";
+export { default as listTeamMembers } from "./listTeamMembers.js";
 export { default as setMobSessionCoauthors } from "./setMobSessionCoauthors.js";
 export { default as clearMobSession } from "./clearMobSession.js";
+export { default as listMobSessionCoauthors } from "./listMobSessionCoauthors.js";
+export { default as listMobSessionCoauthorTrailers } from "./listMobSessionCoauthorTrailers.js";

package/dist/tools/listMobSessionCoauthorTrailers.js

@@ -0,0 +1,26 @@
+import { listMobSessionCoauthorTrailers } from "../clients/gitMobClient.js";
+const name = "list_mob_session_coauthor_trailers";
+const description = "Lists the git Co-authored-by trailers for the coauthors " +
+    "currently included in the active mob or pairing session. " +
+    "If Git Mob is setup, these Co-authored-by trailers will be automatically " +
+    "added to the commit's message when making commits during the session.";
+const inputSchema = {};
+const annotations = {
+    title: "List Mob Session Coauthor Trailers",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const callback = async () => {
+    const { ok, value } = await listMobSessionCoauthorTrailers();
+    return { isError: !ok, content: [{ type: "text", text: value || "" }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/dist/tools/listMobSessionCoauthors.js

@@ -0,0 +1,25 @@
+import { listMobSessionCoauthors } from "../clients/gitMobClient.js";
+const name = "list_mob_session_coauthors";
+const description = "Lists all coauthors currently included in the active mob or pairing session. " +
+    "If Git Mob is setup, these coauthors will be automatically added as " +
+    "Co-authored-by trailers to the commit's message when making commits during the session.";
+const inputSchema = {};
+const annotations = {
+    title: "List Mob Session Coauthors",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const callback = async () => {
+    const { ok, value } = await listMobSessionCoauthors();
+    return { isError: !ok, content: [{ type: "text", text: value || "" }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/dist/tools/listTeamMembers.js

@@ -0,0 +1,26 @@
+import { listCoauthors } from "../clients/gitMobClient.js";
+const name = "list_team_members";
+const description = "Lists all team members that have been added to Git Mob. " +
+    "The team members can then be used in pairing / mobbing sessions as coauthors." +
+    "Each entry is formatted as: <key> <name> <email>." +
+    "Ask the user which team member(s) they want to pair or mob with.";
+const inputSchema = {};
+const annotations = {
+    title: "List Team Members",
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const callback = async () => {
+    const { ok, value } = await listCoauthors();
+    return { isError: !ok, content: [{ type: "text", text: value || "" }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-mob-mcp-server",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "MCP Server for git-mob CLI app",
   "main": "dist/index.js",
   "type": "module",
@@ -15,12 +15,13 @@
     "eslint": "eslint .",
     "eslint:fix": "eslint --fix",
     "format": "prettier --write \"**/*.{js,mjs,cjs,ts}\"",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
     "lint": "npm-run-all typecheck eslint",
     "lint:fix": "npm-run-all format typecheck eslint:fix",
-    "start": "node --experimental-strip-types src/index.ts",
+    "start": "npm-run-all --parallel watch inspect",
     "test": "jest",
     "typecheck": "tsc --noEmit",
-    "watch": "node --experimental-strip-types --watch src/index.ts"
+    "watch": "tsc --watch"
   },
   "publishConfig": {
     "access": "public",

package/dist/helpers/registerGitMobResourceAsTool.js

@@ -1,29 +0,0 @@
-import { URL } from "node:url";
-export const registerGtMobResourceAsTool = (server, resource) => {
-    const { name, uri, metadata, readCallback } = resource;
-    const toolName = `get_${name}`;
-    const annotations = {
-        title: toolName,
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    };
-    const toolCallback = async (_args, extra) => {
-        const resourceResult = await readCallback(new URL(uri), extra);
-        const toolResult = {
-            content: resourceResult.contents
-                .filter((content) => typeof content.text === "string")
-                .map((content) => ({
-                type: "text",
-                text: content.text,
-            })),
-        };
-        return toolResult;
-    };
-    server.registerTool(toolName, {
-        description: String(metadata.description),
-        inputSchema: {},
-        annotations,
-    }, toolCallback);
-};

package/dist/resources/mobSessionCoauthorTrailers.js

@@ -1,39 +0,0 @@
-import {} from "@modelcontextprotocol/sdk/server/mcp.js";
-import { listMobSessionCoauthorTrailers } from "../clients/gitMobClient.js";
-const name = "mob_session_coauthor_trailers";
-const uri = "gitmob://mob-session-coauthor-trailers";
-const metadata = {
-    description: "List of the git Co-authored-by trailers for the coauthors " +
-        "currently included in the active mob or pairing session. " +
-        "If Git Mob is setup, these Co-authored-by trailers will be automatically " +
-        "added to the commit's message when making commits during the session.",
-    mimeType: "text/plain",
-};
-const readCallback = async (uri) => {
-    const { ok, value } = await listMobSessionCoauthorTrailers();
-    if (!ok) {
-        return {
-            isError: true,
-            contents: [
-                {
-                    uri: uri.href,
-                    text: value,
-                },
-            ],
-        };
-    }
-    const lines = value.split("\n").filter((line) => line.trim() !== "");
-    return {
-        contents: lines.map((line) => ({
-            uri: uri.href,
-            text: line,
-        })),
-    };
-};
-const resource = {
-    name,
-    uri,
-    metadata,
-    readCallback,
-};
-export default resource;

package/dist/resources/mobSessionCoauthors.js

@@ -1,38 +0,0 @@
-import {} from "@modelcontextprotocol/sdk/server/mcp.js";
-import { listMobSessionCoauthors } from "../clients/gitMobClient.js";
-const name = "mob_session_coauthors";
-const uri = "gitmob://mob-session-coauthors";
-const metadata = {
-    description: "List of all coauthors currently included in the active mob or pairing session. " +
-        "If Git Mob is setup, these coauthors will be automatically added as " +
-        "Co-authored-by trailers to the commit's message when making commits during the session.",
-    mimeType: "text/plain",
-};
-const readCallback = async (uri) => {
-    const { ok, value } = await listMobSessionCoauthors();
-    if (!ok) {
-        return {
-            isError: true,
-            contents: [
-                {
-                    uri: uri.href,
-                    text: value,
-                },
-            ],
-        };
-    }
-    const lines = value.split("\n").filter((line) => line.trim() !== "");
-    return {
-        contents: lines.map((line) => ({
-            uri: uri.href,
-            text: line,
-        })),
-    };
-};
-const resource = {
-    name,
-    uri,
-    metadata,
-    readCallback,
-};
-export default resource;

package/dist/resources/teamMembers.js

@@ -1,39 +0,0 @@
-import {} from "@modelcontextprotocol/sdk/server/mcp.js";
-import { listCoauthors } from "../clients/gitMobClient.js";
-const name = "team_members";
-const uri = "gitmob://team-members";
-const metadata = {
-    description: "List of all the team members that have been added to Git Mob. " +
-        "The team members can then be used in pairing / mobbing sessions as coauthors." +
-        "Each entry is formatted as: <key> <name> <email>." +
-        "Ask the user which team member(s) they want to pair or mob with.",
-    mimeType: "text/plain",
-};
-const readCallback = async (uri) => {
-    const { ok, value } = await listCoauthors();
-    if (!ok) {
-        return {
-            isError: true,
-            contents: [
-                {
-                    uri: uri.href,
-                    text: value,
-                },
-            ],
-        };
-    }
-    const lines = (value || "").split("\n").filter((line) => line.trim() !== "");
-    return {
-        contents: lines.map((line) => ({
-            uri: uri.href,
-            text: line,
-        })),
-    };
-};
-const resource = {
-    name,
-    uri,
-    metadata,
-    readCallback,
-};
-export default resource;