git-mob-mcp-server 1.0.0

package/dist/resources/gitMobHelp.js

@@ -0,0 +1,29 @@
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getHelp } from "../clients/gitMobClient.js";
+const name = "git_mob_help";
+const template = new ResourceTemplate("gitmob://help", { list: undefined });
+const metadata = {
+    description: "Displays 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",
+};
+const readCallback = async (uri, { command }) => {
+    const { ok, value } = await getHelp(command);
+    return {
+        isError: !ok,
+        contents: [
+            {
+                uri: uri.href,
+                text: value,
+            },
+        ],
+    };
+};
+const resource = {
+    name,
+    template,
+    metadata,
+    readCallback,
+};
+export default resource;

package/dist/resources/gitMobHelp.test.js

@@ -0,0 +1,23 @@
+import resource from "./gitMobHelp";
+import { describe, it, expect } from "@jest/globals";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+describe("[resources] gitMobHelp", () => {
+    it("should have correct name", () => {
+        expect(resource.name).toBe("git_mob_help");
+    });
+    it("should have correct template", () => {
+        const template = new ResourceTemplate("gitmob://help", {
+            list: undefined,
+        });
+        expect(resource.template).toEqual(template);
+    });
+    it("should have correct metadata", () => {
+        const metadata = {
+            description: "Displays 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",
+        };
+        expect(resource.metadata).toEqual(metadata);
+    });
+});

package/dist/resources/gitMobVersion.js

@@ -0,0 +1,27 @@
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getVersion } from "../clients/gitMobClient.js";
+const name = "git_mob_version";
+const template = new ResourceTemplate("gitmob://version", { list: undefined });
+const metadata = {
+    description: "The installed version of the Git Mob CLI.",
+    mimeType: "text/plain",
+};
+const readCallback = async (uri) => {
+    const { ok, value } = await getVersion();
+    return {
+        isError: !ok,
+        contents: [
+            {
+                uri: uri.href,
+                text: value,
+            },
+        ],
+    };
+};
+const resource = {
+    name,
+    template,
+    metadata,
+    readCallback,
+};
+export default resource;

package/dist/resources/gitMobVersion.test.js

@@ -0,0 +1,19 @@
+import resource from "./gitMobVersion";
+import { describe, it, expect } from "@jest/globals";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+describe("[resources] gitMobVersion", () => {
+    it("should have correct name", () => {
+        expect(resource.name).toBe("git_mob_version");
+    });
+    it("should have correct template", () => {
+        const template = new ResourceTemplate("gitmob://version", { list: undefined });
+        expect(resource.template).toEqual(template);
+    });
+    it("should have correct metadata", () => {
+        const metadata = {
+            description: "The installed version of the Git Mob CLI.",
+            mimeType: "text/plain",
+        };
+        expect(resource.metadata).toEqual(metadata);
+    });
+});

package/dist/resources/index.js

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

package/dist/resources/mobSessionCoauthorTrailers.js

@@ -0,0 +1,39 @@
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { listMobSessionCoauthorTrailers } from "../clients/gitMobClient.js";
+const name = "mob_session_coauthor_trailers";
+const template = new ResourceTemplate("gitmob://mob-session-coauthor-trailers", { list: undefined });
+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,
+    template,
+    metadata,
+    readCallback,
+};
+export default resource;

package/dist/resources/mobSessionCoauthorTrailers.test.js

@@ -0,0 +1,22 @@
+import resource from "./mobSessionCoauthorTrailers";
+import { describe, it, expect } from "@jest/globals";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+describe("[resources] mobSessionCoauthorTrailers", () => {
+    it("should have correct name", () => {
+        expect(resource.name).toBe("mob_session_coauthor_trailers");
+    });
+    it("should have correct template", () => {
+        const template = new ResourceTemplate("gitmob://mob-session-coauthor-trailers", { list: undefined });
+        expect(resource.template).toEqual(template);
+    });
+    it("should have correct metadata", () => {
+        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",
+        };
+        expect(resource.metadata).toEqual(metadata);
+    });
+});

package/dist/resources/mobSessionCoauthors.js

@@ -0,0 +1,40 @@
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { listMobSessionCoauthors } from "../clients/gitMobClient.js";
+const name = "mob_session_coauthors";
+const template = new ResourceTemplate("gitmob://mob-session-coauthors", {
+    list: undefined,
+});
+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,
+    template,
+    metadata,
+    readCallback,
+};
+export default resource;

package/dist/resources/mobSessionCoauthors.test.js

@@ -0,0 +1,21 @@
+import resource from "./mobSessionCoauthors";
+import { describe, it, expect } from "@jest/globals";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+describe("[resources] mobSessionCoauthors", () => {
+    it("should have correct name", () => {
+        expect(resource.name).toBe("mob_session_coauthors");
+    });
+    it("should have correct template", () => {
+        const template = new ResourceTemplate("gitmob://mob-session-coauthors", { list: undefined });
+        expect(resource.template).toEqual(template);
+    });
+    it("should have correct metadata", () => {
+        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",
+        };
+        expect(resource.metadata).toEqual(metadata);
+    });
+});

package/dist/resources/teamMembers.js

@@ -0,0 +1,41 @@
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { listCoauthors } from "../clients/gitMobClient.js";
+const name = "team_members";
+const template = new ResourceTemplate("gitmob://team-members", {
+    list: undefined,
+});
+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,
+    template,
+    metadata,
+    readCallback,
+};
+export default resource;

package/dist/resources/teamMembers.test.js

@@ -0,0 +1,22 @@
+import resource from "./teamMembers";
+import { describe, it, expect } from "@jest/globals";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+describe("[resources] teamMembers", () => {
+    it("should have correct name", () => {
+        expect(resource.name).toBe("team_members");
+    });
+    it("should have correct template", () => {
+        const template = new ResourceTemplate("gitmob://team-members", { list: undefined });
+        expect(resource.template).toEqual(template);
+    });
+    it("should have correct metadata", () => {
+        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",
+        };
+        expect(resource.metadata).toEqual(metadata);
+    });
+});

package/dist/tools/addTeamMember.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { addCoauthor } from "../clients/gitMobClient.js";
+const name = "add_team_member";
+const description = "Adds a new team member using their key, name, and email. " +
+    "This member can then be used in a pairing or mobbing sessions as a cauthor. " +
+    "The first name is a good choice for the key." +
+    "Ask the user if they want mob or pair with this team member.";
+const inputSchema = {
+    key: z.string(),
+    name: z.string(),
+    email: z.string(),
+};
+const annotations = {
+    title: "Add Team Member",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: false,
+    openWorldHint: false,
+};
+const callback = async ({ key, name, email, }) => {
+    const { ok, value } = await addCoauthor(key, name, email);
+    return { isError: !ok, content: [{ type: "text", text: value }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/dist/tools/addTeamMember.test.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import tool from "./addTeamMember.js";
+import { describe, it, expect } from "@jest/globals";
+describe("[tools] addTeamMember", () => {
+    it("should have correct name", () => {
+        expect(tool.name).toBe("add_team_member");
+    });
+    it("should have correct description", () => {
+        const description = "Adds a new team member using their key, name, and email. " +
+            "This member can then be used in a pairing or mobbing sessions as a cauthor. " +
+            "The first name is a good choice for the key." +
+            "Ask the user if they want mob or pair with this team member.";
+        expect(tool.description).toBe(description);
+    });
+    it("should have correct input schema", () => {
+        const inputSchema = {
+            key: z.string(),
+            name: z.string(),
+            email: z.string(),
+        };
+        expect(JSON.stringify(tool.inputSchema)).toEqual(JSON.stringify(inputSchema));
+    });
+    it("should have correct annotations", () => {
+        const annotations = {
+            title: "Add Team Member",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        };
+        expect(tool.annotations).toEqual(annotations);
+    });
+});

package/dist/tools/clearMobSession.js

@@ -0,0 +1,23 @@
+import { clearMobSession } from "../clients/gitMobClient.js";
+const name = "clear_mob_session";
+const description = "Clears the active mob or pairing session.";
+const inputSchema = {};
+const annotations = {
+    title: "Clear Mob Session",
+    readOnlyHint: false,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const callback = async () => {
+    const { ok, value } = await clearMobSession();
+    return { isError: !ok, content: [{ type: "text", text: value }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/dist/tools/clearMobSession.test.js

@@ -0,0 +1,25 @@
+import tool from "./clearMobSession.js";
+import { describe, it, expect } from "@jest/globals";
+describe("[tools] clearMobSession", () => {
+    it("should have correct name", () => {
+        expect(tool.name).toBe("clear_mob_session");
+    });
+    it("should have correct description", () => {
+        const description = "Clears the active mob or pairing session.";
+        expect(tool.description).toBe(description);
+    });
+    it("should have correct input schema", () => {
+        const inputSchema = {};
+        expect(JSON.stringify(tool.inputSchema)).toEqual(JSON.stringify(inputSchema));
+    });
+    it("should have correct annotations", () => {
+        const annotations = {
+            title: "Clear Mob Session",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        };
+        expect(tool.annotations).toEqual(annotations);
+    });
+});

package/dist/tools/deleteTeamMember.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { deleteCoauthor } from "../clients/gitMobClient.js";
+const name = "delete_team_member";
+const description = "Deletes a team member by their key. " +
+    "User can only delete a team member they have added previously. " +
+    "If user did not specify a key, show them list of existing team members and ask them to select one.";
+const inputSchema = {
+    key: z.string(),
+};
+const annotations = {
+    title: "Delete Team Member",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const callback = async ({ key }) => {
+    const { ok, value } = await deleteCoauthor(key);
+    return { isError: !ok, content: [{ type: "text", text: value }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/dist/tools/deleteTeamMember.test.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import tool from "./deleteTeamMember.js";
+import { describe, it, expect } from "@jest/globals";
+describe("[tools] deleteTeamMember", () => {
+    it("should have correct name", () => {
+        expect(tool.name).toBe("delete_team_member");
+    });
+    it("should have correct description", () => {
+        const description = "Deletes a team member by their key. " +
+            "User can only delete a team member they have added previously. " +
+            "If user did not specify a key, show them list of existing team members and ask them to select one.";
+        expect(tool.description).toBe(description);
+    });
+    it("should have correct input schema", () => {
+        const inputSchema = {
+            key: z.string(),
+        };
+        expect(JSON.stringify(tool.inputSchema)).toEqual(JSON.stringify(inputSchema));
+    });
+    it("should have correct annotations", () => {
+        const annotations = {
+            title: "Delete Team Member",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        };
+        expect(tool.annotations).toEqual(annotations);
+    });
+});

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+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 setMobSessionCoauthors } from "./setMobSessionCoauthors.js";
+export { default as clearMobSession } from "./clearMobSession.js";

package/dist/tools/setMobSessionCoauthors.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { setMobSession } from "../clients/gitMobClient.js";
+const name = "set_mob_session_coauthors";
+const description = "Sets the active pairing or mob session by specifying the " +
+    "keys of the team members to include as coauthors. " +
+    "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 = {
+    coauthorKeys: z.array(z.string()).min(1),
+};
+const annotations = {
+    title: "Set Mob or Pairing Session Coauthors using Team Members",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+const callback = async ({ coauthorKeys }) => {
+    const { ok, value } = await setMobSession(coauthorKeys);
+    return { isError: !ok, content: [{ type: "text", text: value }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/dist/tools/setMobSessionCoauthors.test.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import tool from "./setMobSessionCoauthors.js";
+import { describe, it, expect } from "@jest/globals";
+describe("[tools] setMobSessionCoauthors", () => {
+    it("should have correct name", () => {
+        expect(tool.name).toBe("set_mob_session_coauthors");
+    });
+    it("should have correct description", () => {
+        const description = "Sets the active pairing or mob session by specifying the " +
+            "keys of the team members to include as coauthors. " +
+            "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.";
+        expect(tool.description).toBe(description);
+    });
+    it("should have correct input schema", () => {
+        const inputSchema = {
+            coauthorKeys: z.array(z.string()).min(1),
+        };
+        expect(JSON.stringify(tool.inputSchema)).toEqual(JSON.stringify(inputSchema));
+    });
+    it("should have correct annotations", () => {
+        const annotations = {
+            title: "Set Mob or Pairing Session Coauthors using Team Members",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        };
+        expect(tool.annotations).toEqual(annotations);
+    });
+});

package/dist/tools/setupGitMobGlobally.js

@@ -0,0 +1,27 @@
+import { setupGlobal } from "../clients/gitMobClient.js";
+const name = "setup_git_mob_globally";
+const description = "Configures the Git Mob CLI globally for all repositories on your system. " +
+    "This one-time setup installs a global prepare-commit-msg git hook, which automatically " +
+    "appends Co-authored-by trailers to commit messages during mob or pairing sessions. " +
+    "If a repository overrides the core.hooksPath git configuration (e.g., when using " +
+    "Husky), the setupGitMobLocally tool needs to be invoked in addition to this. ";
+const inputSchema = {};
+const annotations = {
+    title: "Setup Git Mob Globally",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false,
+};
+const callback = async () => {
+    const { ok, value } = await setupGlobal();
+    return { isError: !ok, content: [{ type: "text", text: value }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;

package/dist/tools/setupGitMobGlobally.test.js

@@ -0,0 +1,29 @@
+import tool from "./setupGitMobGlobally.js";
+import { describe, it, expect } from "@jest/globals";
+describe("[tools] setupGitMobGlobally", () => {
+    it("should have correct name", () => {
+        expect(tool.name).toBe("setup_git_mob_globally");
+    });
+    it("should have correct description", () => {
+        const description = "Configures the Git Mob CLI globally for all repositories on your system. " +
+            "This one-time setup installs a global prepare-commit-msg git hook, which automatically " +
+            "appends Co-authored-by trailers to commit messages during mob or pairing sessions. " +
+            "If a repository overrides the core.hooksPath git configuration (e.g., when using " +
+            "Husky), the setupGitMobLocally tool needs to be invoked in addition to this. ";
+        expect(tool.description).toBe(description);
+    });
+    it("should have correct input schema", () => {
+        const inputSchema = {};
+        expect(JSON.stringify(tool.inputSchema)).toEqual(JSON.stringify(inputSchema));
+    });
+    it("should have correct annotations", () => {
+        const annotations = {
+            title: "Setup Git Mob Globally",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        };
+        expect(tool.annotations).toEqual(annotations);
+    });
+});

package/dist/tools/setupGitMobLocally.js

@@ -0,0 +1,28 @@
+import { setupLocal } from "../clients/gitMobClient.js";
+const name = "setup_git_mob_locally";
+const description = "Sets up the Git Mob CLI for the current repository by installing a local " +
+    "prepare-commit-msg git hook. This hook delegates to the global " +
+    "prepare-commit-msg hook configured by setupGitMobGlobally. Use this tool " +
+    "only if your repository overrides the core.hooksPath git " +
+    "configuration (e.g., when using Husky). Note: You must run " +
+    "setupGitMobGlobally at least once before using this tool.";
+const inputSchema = {};
+const annotations = {
+    title: "Setup Git Mob Locally",
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: false,
+};
+const callback = async () => {
+    const { ok, value } = await setupLocal();
+    return { isError: !ok, content: [{ type: "text", text: value }] };
+};
+const tool = {
+    name,
+    description,
+    inputSchema,
+    annotations,
+    callback,
+};
+export default tool;