merlin-mcp 0.2.0

package/dist/utils/git.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Git Utilities
+ * Detect current repository from git configuration
+ */
+/** Result of repository detection */
+export interface RepoDetectionResult {
+    /** GitHub URL of the repository */
+    url: string;
+    /** Detected branch name */
+    branch: string;
+    /** Root directory of the repository */
+    rootDir: string;
+}
+/**
+ * Find the git root directory by walking up from current directory
+ */
+export declare function findGitRoot(startDir?: string): Promise<string | null>;
+/**
+ * Normalize a git remote URL to a standard GitHub URL format
+ */
+export declare function normalizeGitUrl(url: string): string;
+/**
+ * Detect the current repository from git configuration
+ */
+export declare function detectRepository(workingDir?: string): Promise<RepoDetectionResult | null>;
+/**
+ * Extract owner and repo name from a GitHub URL
+ */
+export declare function parseGitHubUrl(url: string): {
+    owner: string;
+    repo: string;
+} | null;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcnD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAoD/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAalF"}

package/dist/utils/git.js

@@ -0,0 +1,109 @@
+/**
+ * Git Utilities
+ * Detect current repository from git configuration
+ */
+import { simpleGit } from 'simple-git';
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * Find the git root directory by walking up from current directory
+ */
+export async function findGitRoot(startDir) {
+    let currentDir = startDir || process.cwd();
+    while (currentDir !== path.dirname(currentDir)) {
+        const gitDir = path.join(currentDir, '.git');
+        try {
+            const stat = await fs.promises.stat(gitDir);
+            if (stat.isDirectory() || stat.isFile()) {
+                return currentDir;
+            }
+        }
+        catch {
+            // .git doesn't exist here, keep walking up
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+}
+/**
+ * Normalize a git remote URL to a standard GitHub URL format
+ */
+export function normalizeGitUrl(url) {
+    // Handle SSH URLs: git@github.com:owner/repo.git
+    if (url.startsWith('git@')) {
+        url = url
+            .replace(/^git@github\.com:/, 'https://github.com/')
+            .replace(/\.git$/, '');
+    }
+    // Handle HTTPS URLs: https://github.com/owner/repo.git
+    if (url.startsWith('https://') || url.startsWith('http://')) {
+        url = url.replace(/\.git$/, '');
+    }
+    return url;
+}
+/**
+ * Detect the current repository from git configuration
+ */
+export async function detectRepository(workingDir) {
+    try {
+        // Find git root
+        const rootDir = await findGitRoot(workingDir);
+        if (!rootDir) {
+            return null;
+        }
+        const git = simpleGit(rootDir);
+        // Get remotes
+        const remotes = await git.getRemotes(true);
+        // Find origin or first remote with a GitHub URL
+        let remoteUrl = null;
+        // Prefer 'origin' remote
+        const origin = remotes.find(r => r.name === 'origin');
+        if (origin?.refs?.fetch) {
+            remoteUrl = origin.refs.fetch;
+        }
+        else if (origin?.refs?.push) {
+            remoteUrl = origin.refs.push;
+        }
+        // Fall back to any remote with a GitHub URL
+        if (!remoteUrl) {
+            for (const remote of remotes) {
+                const url = remote.refs?.fetch || remote.refs?.push;
+                if (url && url.includes('github.com')) {
+                    remoteUrl = url;
+                    break;
+                }
+            }
+        }
+        if (!remoteUrl) {
+            return null;
+        }
+        // Get current branch
+        const branchSummary = await git.branch();
+        const branch = branchSummary.current || 'main';
+        return {
+            url: normalizeGitUrl(remoteUrl),
+            branch,
+            rootDir,
+        };
+    }
+    catch (error) {
+        console.error('Error detecting repository:', error);
+        return null;
+    }
+}
+/**
+ * Extract owner and repo name from a GitHub URL
+ */
+export function parseGitHubUrl(url) {
+    const normalized = normalizeGitUrl(url);
+    // Match https://github.com/owner/repo
+    const match = normalized.match(/github\.com\/([^\/]+)\/([^\/]+)/);
+    if (match) {
+        return {
+            owner: match[1],
+            repo: match[2],
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "merlin-mcp",
+  "version": "0.2.0",
+  "description": "Merlin MCP Server - AI-powered codebase intelligence for coding agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "merlin-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "ai",
+    "coding-assistant",
+    "codebase-context"
+  ],
+  "author": "Merlin",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/merlin"
+  },
+  "homepage": "https://merlin.build",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "simple-git": "^3.21.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.6.2",
+    "typescript": "^5.3.0"
+  }
+}