gitstandup-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GitStandup Contributors
+
+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

@@ -0,0 +1,205 @@
+# GitStandup MCP Server
+
+> Generate daily standup notes from your git commits using AI
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that automatically collects your git commits from multiple repositories and helps AI assistants generate natural, comprehensive standup summaries.
+
+## ✨ Features
+
+- 📦 **Multi-repo support** - Track commits across all your projects
+- 👤 **User-specific** - Only shows your commits (filtered by git user.email)
+- ⏰ **Time-based** - Configurable lookback period (default: last 24 hours)
+- 🎯 **Smart diff analysis** - Includes code changes with intelligent truncation
+- 💾 **Persistent config** - Remembers your repos in `~/.gitstandup/config.json`
+- 🧹 **Clean output** - Skips generated files (lock files, minified code)
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Using npx (no installation needed)
+npx -y gitstandup-mcp
+
+# Or install globally
+npm install -g gitstandup-mcp
+```
+
+### Setup with Claude Desktop
+
+Add to your Claude Desktop config at `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gitstandup": {
+      "command": "npx",
+      "args": ["-y", "gitstandup-mcp"]
+    }
+  }
+}
+```
+
+### Setup with VS Code (GitHub Copilot)
+
+Add to your VS Code MCP settings:
+
+```json
+{
+  "gitstandup": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "gitstandup-mcp"]
+  }
+}
+```
+
+## 📖 Usage
+
+Once configured, you can use natural language with your AI assistant:
+
+```
+"Generate my standup notes"
+"What did I work on yesterday?"
+"Show my commits from the last 2 days"
+```
+
+### First Time Setup
+
+1. **Add your repositories:**
+
+   ```
+   "Add /path/to/my/project to GitStandup"
+   ```
+
+2. **Generate standup notes:**
+
+   ```
+   "Generate my standup notes"
+   ```
+
+3. **The AI will create a summary like:**
+   > Yesterday I:
+   >
+   > - Implemented OAuth authentication flow in the api-server
+   > - Fixed critical bug in payment processing
+   > - Added integration tests for user registration
+
+## 🛠️ Available Tools
+
+The server exposes four MCP tools that AI assistants can use:
+
+### `generate_standup`
+
+Generate standup notes from configured repositories.
+
+**Parameters:**
+
+- `hours` (optional): Number of hours to look back (default: 24)
+- `repos` (optional): Array of specific repo paths to use
+
+**Example:**
+
+```typescript
+{
+  "hours": 48,  // Last 2 days
+  "repos": ["/path/to/repo1", "/path/to/repo2"]  // Optional
+}
+```
+
+### `add_repos`
+
+Add repository paths to the configuration.
+
+**Parameters:**
+
+- `paths`: Array of absolute paths to git repositories
+
+**Example:**
+
+```typescript
+{
+  "paths": ["/Users/you/projects/my-app", "/Users/you/projects/api"]
+}
+```
+
+### `list_repos`
+
+List currently configured repositories.
+
+**Returns:** Array of configured repository paths
+
+### `remove_repos`
+
+Remove repository paths from the configuration.
+
+**Parameters:**
+
+- `paths`: Array of repository paths to remove
+
+## 🔧 Development
+
+```bash
+# Clone the repository
+git clone https://github.com/muba00/gitstandup.git
+cd gitstandup
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test locally
+node build/index.js
+```
+
+### Project Structure
+
+```
+gitstandup/
+├── src/
+│   ├── index.ts      # MCP server setup and tool definitions
+│   ├── git.ts        # Git operations and commit collection
+│   └── config.ts     # Configuration management
+├── build/            # Compiled JavaScript (generated)
+└── package.json
+```
+
+## 📝 Configuration
+
+Repository paths are stored in `~/.gitstandup/config.json`:
+
+```json
+{
+  "repos": ["/Users/you/projects/project1", "/Users/you/projects/project2"]
+}
+```
+
+You can edit this file manually or use the `add_repos` and `remove_repos` tools.
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to:
+
+- 🐛 Report bugs
+- 💡 Suggest new features
+- 🔧 Submit pull requests
+
+See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for details.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details
+
+## 🙏 Acknowledgments
+
+Built with:
+
+- [Model Context Protocol SDK](https://github.com/modelcontextprotocol/typescript-sdk)
+- [simple-git](https://github.com/steveukx/git-js)
+- [Zod](https://github.com/colinhacks/zod)
+
+---
+
+**Note:** This tool only reads git commit history and does not modify your repositories.

package/build/config.js

@@ -0,0 +1,34 @@
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import path from "path";
+import os from "os";
+const CONFIG_DIR = path.join(os.homedir(), ".gitstandup");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+/**
+ * Ensure the config directory exists
+ */
+export async function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        await mkdir(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Load configuration from ~/.gitstandup/config.json
+ */
+export async function loadConfig() {
+    try {
+        const data = await readFile(CONFIG_FILE, "utf-8");
+        return JSON.parse(data);
+    }
+    catch (error) {
+        // If file doesn't exist or is invalid, return empty config
+        return { repos: [] };
+    }
+}
+/**
+ * Save configuration to ~/.gitstandup/config.json
+ */
+export async function saveConfig(config) {
+    await ensureConfigDir();
+    await writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+}

package/build/git.js

@@ -0,0 +1,134 @@
+import { simpleGit } from "simple-git";
+import path from "path";
+const MAX_DIFF_LINES_PER_FILE = 500;
+const MAX_DIFF_LINES_PER_COMMIT = 2000;
+/**
+ * Truncate a diff to stay within limits
+ */
+function truncateDiff(diff, maxLines) {
+    const lines = diff.split("\n");
+    if (lines.length <= maxLines) {
+        return diff;
+    }
+    const halfLines = Math.floor(maxLines / 2);
+    const start = lines.slice(0, halfLines);
+    const end = lines.slice(-halfLines);
+    return [
+        ...start,
+        `\n... (${lines.length - maxLines} lines omitted) ...\n`,
+        ...end,
+    ].join("\n");
+}
+/**
+ * Get the current git user email for a repository
+ */
+async function getCurrentUserEmail(git) {
+    try {
+        const email = await git.raw(["config", "user.email"]);
+        return email.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Collect commits from a single repository
+ */
+async function collectRepoCommits(repoPath, hoursAgo) {
+    const repoName = path.basename(repoPath);
+    try {
+        const git = simpleGit(repoPath);
+        // Check if it's a valid git repository
+        const isRepo = await git.checkIsRepo();
+        if (!isRepo) {
+            return {
+                name: repoName,
+                path: repoPath,
+                error: "Not a git repository",
+            };
+        }
+        // Get current user email
+        const userEmail = await getCurrentUserEmail(git);
+        if (!userEmail) {
+            return {
+                name: repoName,
+                path: repoPath,
+                error: "Could not determine git user.email",
+            };
+        }
+        // Calculate time threshold
+        const since = new Date(Date.now() - hoursAgo * 60 * 60 * 1000);
+        const sinceStr = since.toISOString();
+        // Get commits by current user since the time threshold
+        const log = await git.log({
+            "--since": sinceStr,
+            "--author": userEmail,
+            "--all": null,
+        });
+        if (log.all.length === 0) {
+            return {
+                name: repoName,
+                path: repoPath,
+                commits: [],
+            };
+        }
+        // Collect commit details with diffs
+        const commits = [];
+        for (const commit of log.all) {
+            try {
+                // Get the diff for this commit
+                const diffSummary = await git.diffSummary([
+                    `${commit.hash}^`,
+                    commit.hash,
+                ]);
+                // Get full diff, but limit to avoid huge output
+                let fullDiff = await git.diff([`${commit.hash}^`, commit.hash]);
+                // Truncate diff if too large
+                fullDiff = truncateDiff(fullDiff, MAX_DIFF_LINES_PER_COMMIT);
+                // Skip generated files and lock files
+                const relevantFiles = diffSummary.files.filter((f) => {
+                    const fileName = f.file.toLowerCase();
+                    return (!fileName.includes("package-lock.json") &&
+                        !fileName.includes("yarn.lock") &&
+                        !fileName.includes(".min.") &&
+                        !fileName.endsWith(".lock"));
+                });
+                commits.push({
+                    hash: commit.hash.substring(0, 7),
+                    message: commit.message,
+                    author: userEmail,
+                    timestamp: commit.date,
+                    files: relevantFiles.map((f) => f.file),
+                    diff: fullDiff,
+                    stats: {
+                        additions: diffSummary.insertions,
+                        deletions: diffSummary.deletions,
+                    },
+                });
+            }
+            catch (error) {
+                // If we can't get diff for a commit, skip it
+                console.error(`Error getting diff for commit ${commit.hash}:`, error);
+            }
+        }
+        return {
+            name: repoName,
+            path: repoPath,
+            commits,
+        };
+    }
+    catch (error) {
+        return {
+            name: repoName,
+            path: repoPath,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+/**
+ * Collect commits from multiple repositories
+ */
+export async function collectCommits(repoPaths, hoursAgo) {
+    const results = await Promise.all(repoPaths.map((path) => collectRepoCommits(path, hoursAgo)));
+    return results;
+}

package/build/index.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { collectCommits } from "./git.js";
+import { loadConfig, saveConfig, ensureConfigDir } from "./config.js";
+const server = new McpServer({
+    name: "gitstandup-mcp",
+    version: "1.0.0",
+});
+// Tool: generate_standup
+server.registerTool("generate_standup", {
+    title: "Generate Standup Notes",
+    description: "Generate standup notes from git commits in configured repositories",
+    inputSchema: {
+        hours: z.number().optional().describe("Hours to look back (default: 24)"),
+        repos: z
+            .array(z.string())
+            .optional()
+            .describe("Specific repo paths to use instead of configured ones"),
+    },
+    outputSchema: {
+        repos: z.array(z.object({
+            name: z.string(),
+            path: z.string(),
+            commits: z.array(z.object({
+                hash: z.string(),
+                message: z.string(),
+                author: z.string(),
+                timestamp: z.string(),
+                files: z.array(z.string()),
+                diff: z.string(),
+                stats: z.object({
+                    additions: z.number(),
+                    deletions: z.number(),
+                }),
+            })),
+            error: z.string().optional(),
+        })),
+        summary: z.object({
+            totalCommits: z.number(),
+            totalRepos: z.number(),
+            timeRange: z.string(),
+            user: z.string().optional(),
+        }),
+    },
+}, async ({ hours = 24, repos }) => {
+    const config = await loadConfig();
+    const repoPaths = repos || config.repos;
+    if (repoPaths.length === 0) {
+        const output = {
+            repos: [],
+            summary: {
+                totalCommits: 0,
+                totalRepos: 0,
+                timeRange: `last ${hours} hours`,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No repositories configured. Use add_repos tool to add repositories.",
+                },
+            ],
+            structuredContent: output,
+        };
+    }
+    const results = await collectCommits(repoPaths, hours);
+    const totalCommits = results.reduce((sum, r) => sum + (r.commits?.length || 0), 0);
+    const output = {
+        repos: results,
+        summary: {
+            totalCommits,
+            totalRepos: results.length,
+            timeRange: `last ${hours} hours`,
+            user: results[0]?.commits?.[0]?.author,
+        },
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+        structuredContent: output,
+    };
+});
+// Tool: add_repos
+server.registerTool("add_repos", {
+    title: "Add Repositories",
+    description: "Add repository paths to the configuration",
+    inputSchema: {
+        paths: z.array(z.string()).describe("Absolute paths to git repositories"),
+    },
+    outputSchema: {
+        added: z.array(z.string()),
+        repos: z.array(z.string()),
+    },
+}, async ({ paths }) => {
+    await ensureConfigDir();
+    const config = await loadConfig();
+    const newPaths = paths.filter((p) => !config.repos.includes(p));
+    config.repos.push(...newPaths);
+    await saveConfig(config);
+    const output = {
+        added: newPaths,
+        repos: config.repos,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Added ${newPaths.length} repository(ies). Total: ${config.repos.length}`,
+            },
+        ],
+        structuredContent: output,
+    };
+});
+// Tool: list_repos
+server.registerTool("list_repos", {
+    title: "List Repositories",
+    description: "List currently configured repositories",
+    inputSchema: {},
+    outputSchema: {
+        repos: z.array(z.string()),
+        count: z.number(),
+    },
+}, async () => {
+    const config = await loadConfig();
+    const output = {
+        repos: config.repos,
+        count: config.repos.length,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+        structuredContent: output,
+    };
+});
+// Tool: remove_repos
+server.registerTool("remove_repos", {
+    title: "Remove Repositories",
+    description: "Remove repository paths from the configuration",
+    inputSchema: {
+        paths: z.array(z.string()).describe("Repository paths to remove"),
+    },
+    outputSchema: {
+        removed: z.array(z.string()),
+        repos: z.array(z.string()),
+    },
+}, async ({ paths }) => {
+    const config = await loadConfig();
+    const removed = paths.filter((p) => config.repos.includes(p));
+    config.repos = config.repos.filter((p) => !paths.includes(p));
+    await saveConfig(config);
+    const output = {
+        removed,
+        repos: config.repos,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Removed ${removed.length} repository(ies). Remaining: ${config.repos.length}`,
+            },
+        ],
+        structuredContent: output,
+    };
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("GitStandup MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "gitstandup-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for generating daily standup notes from git commits",
+  "type": "module",
+  "bin": {
+    "gitstandup-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "dev": "tsc --watch",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "git",
+    "standup",
+    "commits"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "simple-git": "^3.25.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "files": [
+    "build"
+  ]
+}