mcp-git-fetcher 0.1.0

package/README.md

@@ -0,0 +1,186 @@
+# mcp-git-fetcher
+
+> **MCP 服务**：从公司内部 GitLab 仓库下载 skills/rules 文件到目标 IDE 目录。
+
+支持 **Python** 和 **Node.js** 双版本，选一个即可。
+
+---
+
+## 快速开始
+
+### 方式 A：Node.js（推荐，可 npx）
+
+```bash
+npx -y mcp-git-fetcher
+```
+
+本地开发：
+
+```bash
+git clone <repo-url>
+cd mcp-git-fetcher
+npm install
+npm run build
+```
+
+### 方式 B：Python
+
+```bash
+cd D:\AI Coding\mcp-git\mcp-git-fetcher
+pip install -e .
+```
+
+### 配置环境变量
+
+复制 `.env.example` 为 `.env`，填入实际参数：
+
+```bash
+copy .env.example .env
+```
+
+| 变量 | 说明 | 示例 |
+|------|------|------|
+| `GIT_REPO_URL` | GitLab 仓库地址（**必需**） | `http://10.1.192.33:8090/.../mcp-git-resource.git` |
+| `GIT_AUTH_TOKEN` | GitLab Personal Access Token | `glpat-xxxxxx` |
+| `GIT_BRANCH` | 分支（默认 main） | `main` |
+
+> **Token 说明**：Token 只配在 MCP 客户端配置的 `env` 中，不会写进代码，也不会存到 git 缓存目录。
+
+### 注册为 MCP 服务
+
+#### Hermes Agent
+
+```yaml
+mcp_servers:
+  git-fetcher:
+    command: "npx"
+    args: ["-y", "mcp-git-fetcher"]
+    env:
+      GIT_REPO_URL: "http://10.1.192.33:8090/project/5gboss/wasu/mcp-git-resource.git"
+      GIT_AUTH_TOKEN: "glpat-xxxxx"   # 只在这里配置
+    connect_timeout: 60
+    timeout: 300
+```
+
+#### Trae CN IDE
+
+编辑 `%APPDATA%\Trae CN\User\mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "git-fetcher": {
+      "command": "npx",
+      "args": ["-y", "mcp-git-fetcher"],
+      "env": {
+        "GIT_REPO_URL": "http://10.1.192.33:8090/project/5gboss/wasu/mcp-git-resource.git",
+        "GIT_AUTH_TOKEN": "glpat-xxxxx"
+      }
+    }
+  }
+}
+```
+
+> 如果用 Python 版，把 `command` 改为 `"uv"`，`args` 改为 `["run", "--directory", "D:\\AI Coding\\mcp-git\\mcp-git-fetcher", "mcp-git-fetcher"]`。
+
+---
+
+## 使用方式
+
+### `fetch_resources`
+
+拉取 GitLab 最新代码，同步 `skills/` 和 `rules/` 到指定目录。
+
+**参数：**
+
+| 参数 | 必需 | 说明 |
+|------|------|------|
+| `target_skills_dir` | ✅ | skills 写入目录（如 `.trae/skills` 的绝对路径） |
+| `target_rules_dir` | ✅ | rules 写入目录（如 `.trae/rules` 的绝对路径） |
+| `repo_url` | ❌ | 临时覆盖仓库 URL |
+
+**返回示例：**
+
+```json
+{
+  "success": true,
+  "message": "Synced 12 files (3 skipped, commit a1b2c3d4)",
+  "commit": "a1b2c3d4",
+  "skills": { "copied": 8, "skipped": 2, "errors": [] },
+  "rules": { "copied": 4, "skipped": 1, "errors": [] },
+  "total_copied": 12,
+  "total_skipped": 3
+}
+```
+
+---
+
+## 工作原理
+
+```
+Agent/IDE → fetch_resources
+  ├─ ① git clone/pull 到本地缓存 (~/.mcp-git-fetcher/cache/)
+  ├─ ② 提取仓库中的 skills/ 和 rules/
+  └─ ③ 复制到目标目录（SHA-256 去重，相同则跳过）
+```
+
+- **增量更新**：第二次调用只需 git pull，更快
+- **内容去重**：SHA-256 对比，内容不变不写盘
+- **Token 安全**：只存在于客户端配置，不进代码和 git 缓存
+
+---
+
+## 项目结构
+
+```
+D:\AI Coding\mcp-git\mcp-git-fetcher\
+├── mcp_git_fetcher/        # Python 版源码
+│   ├── server.py           # MCP 服务入口
+│   ├── git_ops.py          # Git 操作
+│   ├── file_sync.py        # 文件同步
+│   └── config.py           # 配置管理
+├── src/                    # Node.js 版源码 (TypeScript)
+│   ├── cli.ts              # MCP 服务入口
+│   ├── git-ops.ts          # Git 操作
+│   ├── file-sync.ts        # 文件同步
+│   └── config.ts           # 配置管理
+├── package.json            # Node.js 依赖 + npm 发布配置
+├── pyproject.toml          # Python 依赖
+├── .env.example            # 环境变量模板
+├── .gitignore
+└── README.md
+```
+
+---
+
+## 环境变量
+
+| 变量 | 必需 | 默认值 | 说明 |
+|------|------|--------|------|
+| `GIT_REPO_URL` | ✅ | — | GitLab 仓库 HTTP(S) 地址 |
+| `GIT_AUTH_TOKEN` | ❌ | — | GitLab Personal Access Token |
+| `GIT_BRANCH` | ❌ | `main` | 拉取的分支 |
+| `SKILLS_SUBDIR` | ❌ | `skills` | 仓库内 skills 目录名 |
+| `RULES_SUBDIR` | ❌ | `rules` | 仓库内 rules 目录名 |
+| `CACHE_DIR` | ❌ | `~/.mcp-git-fetcher/cache` | 本地 Git 缓存目录 |
+| `HTTP_PROXY` | ❌ | — | HTTP 代理 |
+| `HTTPS_PROXY` | ❌ | — | HTTPS 代理 |
+
+---
+
+## 开发
+
+```bash
+# Python 版
+pip install -e .
+python -m mcp_git_fetcher.server
+
+# Node.js 版
+npm install
+npm run build
+node dist/cli.js
+```
+
+## License
+
+MIT

package/dist/analyzer.d.ts

@@ -0,0 +1,20 @@
+export interface ResourceInfo {
+    name: string;
+    relative_path: string;
+    description: string;
+}
+/**
+ * Extract a short description from the beginning of a file.
+ *
+ * Strategies (tried in order):
+ * 1. Python: first docstring
+ * 2. Markdown: first # Title or first non-empty paragraph
+ * 3. YAML/JS/TS: first comment block
+ * 4. Fallback: first 2 meaningful lines
+ */
+export declare function extractDescription(filePath: string): string;
+/**
+ * Scan the repository for skills and rules files with descriptions.
+ */
+export declare function scanResources(repoRoot: string, skillsSubdir: string, rulesSubdir: string): Record<string, ResourceInfo[]>;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6D3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CA0ChC"}

package/dist/analyzer.js

@@ -0,0 +1,111 @@
+import { readFileSync, readdirSync, statSync, existsSync } from "fs";
+import { join, relative } from "path";
+/**
+ * Extract a short description from the beginning of a file.
+ *
+ * Strategies (tried in order):
+ * 1. Python: first docstring
+ * 2. Markdown: first # Title or first non-empty paragraph
+ * 3. YAML/JS/TS: first comment block
+ * 4. Fallback: first 2 meaningful lines
+ */
+export function extractDescription(filePath) {
+    let text;
+    try {
+        text = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+    const lines = text.split(/\r?\n/);
+    // Strategy 1: Python docstring
+    if (filePath.endsWith(".py")) {
+        const m = text.match(/"""(.*?)"""/s);
+        if (m) {
+            return m[1].trim().split("\n")[0].slice(0, 150);
+        }
+    }
+    // Strategy 2: Markdown — first # Title
+    if (filePath.endsWith(".md") || filePath.endsWith(".mdx")) {
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("# ")) {
+                return trimmed.slice(2).trim();
+            }
+        }
+        // fallback: first non-empty paragraph
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed && !trimmed.startsWith("#")) {
+                return trimmed.slice(0, 150);
+            }
+        }
+    }
+    // Strategy 3: YAML/JS/TS — first comment
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("# ")) {
+            return trimmed.slice(2).trim().slice(0, 150);
+        }
+        if (trimmed.startsWith("// ")) {
+            return trimmed.slice(3).trim().slice(0, 150);
+        }
+        if (trimmed.startsWith("/*")) {
+            const end = text.indexOf("*/");
+            if (end > 0) {
+                return text.slice(2, end).trim().slice(0, 150);
+            }
+        }
+    }
+    // Fallback: first non-empty, non-comment line
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith("#") && !trimmed.startsWith("//") && !trimmed.startsWith("/*")) {
+            return trimmed.slice(0, 150);
+        }
+    }
+    return "";
+}
+/**
+ * Scan the repository for skills and rules files with descriptions.
+ */
+export function scanResources(repoRoot, skillsSubdir, rulesSubdir) {
+    const result = { skills: [], rules: [] };
+    for (const [category, subdir] of [["skills", skillsSubdir], ["rules", rulesSubdir]]) {
+        const srcDir = join(repoRoot, subdir);
+        if (!existsSync(srcDir))
+            continue;
+        function walk(current) {
+            const entries = readdirSync(current);
+            for (const entry of entries) {
+                const full = join(current, entry);
+                let stat;
+                try {
+                    stat = statSync(full);
+                }
+                catch {
+                    continue;
+                }
+                if (stat.isDirectory()) {
+                    if (entry.startsWith("."))
+                        continue; // skip hidden dirs
+                    walk(full);
+                    continue;
+                }
+                // Skip hidden files
+                if (entry.startsWith("."))
+                    continue;
+                const relPath = relative(repoRoot, full).replace(/\\/g, "/");
+                const desc = extractDescription(full);
+                result[category].push({
+                    name: entry,
+                    relative_path: relPath,
+                    description: desc || "(no description)",
+                });
+            }
+        }
+        walk(srcDir);
+    }
+    return result;
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/analyzer.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,275 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { copyFileSync, existsSync, mkdirSync, readFileSync } from "fs";
+import { createHash } from "crypto";
+import { dirname, join } from "path";
+import { loadConfig } from "./config.js";
+import { ensureRepo } from "./git-ops.js";
+import { syncAll } from "./file-sync.js";
+import { scanResources } from "./analyzer.js";
+// ── Tool definitions ──────────────────────────────────────────────────────────
+const TOOLS = [
+    {
+        name: "fetch_resources",
+        description: "Fetch all skills and rules files from the configured internal GitLab " +
+            "repository and sync them to target directories. " +
+            "Use this for a full sync of all resources.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target_skills_dir: {
+                    type: "string",
+                    description: "Absolute path for skills files. Example: C:/path/to/.trae/skills",
+                },
+                target_rules_dir: {
+                    type: "string",
+                    description: "Absolute path for rules files. Example: C:/path/to/.trae/rules",
+                },
+                repo_url: {
+                    type: "string",
+                    description: "Optional override for the Git repository URL.",
+                },
+            },
+            required: ["target_skills_dir", "target_rules_dir"],
+        },
+    },
+    {
+        name: "list_resources",
+        description: "Scan the configured GitLab repository and list all available skills/rules " +
+            "with their descriptions. Shows what each file does and what problem it solves. " +
+            "Does not download anything. Use this to see what's available, " +
+            "then use download_resources to pick specific ones.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    enum: ["skills", "rules", "all"],
+                    description: "Filter by category: 'skills', 'rules', or 'all' (default).",
+                },
+                pattern: {
+                    type: "string",
+                    description: "Optional glob pattern to filter by filename (e.g. 'react*', '*.md').",
+                },
+                repo_url: {
+                    type: "string",
+                    description: "Optional override for the Git repository URL.",
+                },
+            },
+        },
+    },
+    {
+        name: "download_resources",
+        description: "Download specific skills or rules files from the GitLab repository " +
+            "by filename pattern. Use list_resources first to see what's available, " +
+            "then download only what you need. Supports glob patterns.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target_skills_dir: {
+                    type: "string",
+                    description: "Absolute path for skills files. Required if downloading skills.",
+                },
+                target_rules_dir: {
+                    type: "string",
+                    description: "Absolute path for rules files. Required if downloading rules.",
+                },
+                patterns: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filename patterns to match (e.g. ['react*', '*.md', 'cod*']). " +
+                        "Only files matching any pattern will be downloaded.",
+                },
+                category: {
+                    type: "string",
+                    enum: ["skills", "rules", "all"],
+                    description: "Which category to search: 'skills', 'rules', or 'all' (default).",
+                },
+                repo_url: {
+                    type: "string",
+                    description: "Optional override for the Git repository URL.",
+                },
+            },
+            required: ["patterns"],
+        },
+    },
+];
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function makeResult(success, message, details) {
+    const payload = { success, message };
+    if (details)
+        Object.assign(payload, details);
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+    };
+}
+function fileHash(filePath) {
+    const hash = createHash("sha256");
+    hash.update(readFileSync(filePath));
+    return hash.digest("hex");
+}
+function matchGlob(name, pattern) {
+    const regexStr = "^" +
+        pattern
+            .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+            .replace(/\*/g, ".*")
+            .replace(/\?/g, ".") +
+        "$";
+    return new RegExp(regexStr, "i").test(name);
+}
+function filterByPatternSimple(items, patterns) {
+    const pats = Array.isArray(patterns) ? patterns : [patterns];
+    return items.filter((item) => pats.some((p) => matchGlob(item.name, p)));
+}
+// ── Server setup ──────────────────────────────────────────────────────────────
+const server = new Server({ name: "mcp-git-fetcher", version: "0.1.0" }, { capabilities: { tools: {} } });
+// ── Tools/list ────────────────────────────────────────────────────────────────
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: TOOLS,
+}));
+// ── Tools/call ────────────────────────────────────────────────────────────────
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (!name)
+        return makeResult(false, "Missing tool name");
+    try {
+        switch (name) {
+            case "list_resources":
+                return await handleListResources(args);
+            case "download_resources":
+                return await handleDownloadResources(args);
+            case "fetch_resources":
+                return await handleFetchResources(args);
+            default:
+                return makeResult(false, `Unknown tool: ${name}`);
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`[mcp-git-fetcher] Error: ${msg}`);
+        return makeResult(false, msg);
+    }
+});
+// ── Handler: fetch_resources ──────────────────────────────────────────────────
+async function handleFetchResources(args) {
+    const config = loadConfig();
+    if (args.repo_url)
+        config.repoUrl = String(args.repo_url);
+    const targetSkillsDir = args.target_skills_dir;
+    const targetRulesDir = args.target_rules_dir;
+    if (!targetSkillsDir || !targetRulesDir) {
+        return makeResult(false, "Both target_skills_dir and target_rules_dir are required");
+    }
+    console.error(`[mcp-git-fetcher] fetch_resources: repo=${config.repoUrl}`);
+    const repo = await ensureRepo(config);
+    const results = syncAll(repo.repoRoot, config.skillsSubdir, config.rulesSubdir, targetSkillsDir, targetRulesDir);
+    const skillsR = results.skills;
+    const rulesR = results.rules;
+    const totalCopied = (skillsR?.copied ?? 0) + (rulesR?.copied ?? 0);
+    const totalSkipped = (skillsR?.skipped ?? 0) + (rulesR?.skipped ?? 0);
+    const errors = [...(skillsR?.errors ?? []), ...(rulesR?.errors ?? [])];
+    return makeResult(errors.length === 0, `Synced ${totalCopied} files (${totalSkipped} skipped, commit ${repo.commitSha})`, { commit: repo.commitSha, skills: skillsR, rules: rulesR, total_copied: totalCopied, total_skipped: totalSkipped });
+}
+// ── Handler: list_resources ───────────────────────────────────────────────────
+async function handleListResources(args) {
+    const config = loadConfig();
+    if (args.repo_url)
+        config.repoUrl = String(args.repo_url);
+    const repo = await ensureRepo(config);
+    const category = args.category || "all";
+    const pattern = args.pattern || "*";
+    const all = scanResources(repo.repoRoot, config.skillsSubdir, config.rulesSubdir);
+    const result = {};
+    if (category === "skills" || category === "all") {
+        result.skills = filterByPatternSimple(all.skills, pattern);
+    }
+    if (category === "rules" || category === "all") {
+        result.rules = filterByPatternSimple(all.rules, pattern);
+    }
+    const total = Object.values(result).reduce((s, v) => s + v.length, 0);
+    return makeResult(true, `Found ${total} resources (commit ${repo.commitSha})`, {
+        commit: repo.commitSha,
+        resources: result,
+        total,
+    });
+}
+// ── Handler: download_resources ───────────────────────────────────────────────
+async function handleDownloadResources(args) {
+    const config = loadConfig();
+    if (args.repo_url)
+        config.repoUrl = String(args.repo_url);
+    const patterns = args.patterns;
+    if (!Array.isArray(patterns) || patterns.length === 0) {
+        return makeResult(false, "At least one pattern is required (e.g. ['react*', '*.md'])");
+    }
+    const targetSkillsDir = args.target_skills_dir;
+    const targetRulesDir = args.target_rules_dir;
+    const category = args.category || "all";
+    if ((category === "skills" || category === "all") && !targetSkillsDir) {
+        return makeResult(false, "target_skills_dir is required when downloading skills");
+    }
+    if ((category === "rules" || category === "all") && !targetRulesDir) {
+        return makeResult(false, "target_rules_dir is required when downloading rules");
+    }
+    console.error(`[mcp-git-fetcher] download_resources: patterns=${JSON.stringify(patterns)}, category=${category}`);
+    const repo = await ensureRepo(config);
+    const all = scanResources(repo.repoRoot, config.skillsSubdir, config.rulesSubdir);
+    const toDownload = [];
+    if (category === "skills" || category === "all") {
+        const skillsRoot = join(repo.repoRoot, config.skillsSubdir);
+        for (const item of filterByPatternSimple(all.skills, patterns)) {
+            const item2 = item;
+            const src = join(repo.repoRoot, item2.relative_path);
+            const rel = join(skillsRoot, item2.relative_path.replace(config.skillsSubdir + "/", "")); // Hmm, simpler:
+            const relpath = item2.relative_path.replace(config.skillsSubdir + "/", "");
+            toDownload.push({ src, dst: join(targetSkillsDir, relpath) });
+        }
+    }
+    if (category === "rules" || category === "all") {
+        const rulesRoot = join(repo.repoRoot, config.rulesSubdir);
+        for (const item of filterByPatternSimple(all.rules, patterns)) {
+            const item2 = item;
+            const src = join(repo.repoRoot, item2.relative_path);
+            const relpath = item2.relative_path.replace(config.rulesSubdir + "/", "");
+            toDownload.push({ src, dst: join(targetRulesDir, relpath) });
+        }
+    }
+    // Execute downloads
+    let copied = 0;
+    let skipped = 0;
+    const errors = [];
+    for (const { src, dst } of toDownload) {
+        mkdirSync(dirname(dst), { recursive: true });
+        if (existsSync(dst)) {
+            try {
+                if (fileHash(src) === fileHash(dst)) {
+                    skipped++;
+                    continue;
+                }
+            }
+            catch {
+                // fall through
+            }
+        }
+        try {
+            copyFileSync(src, dst);
+            copied++;
+        }
+        catch (e) {
+            errors.push(`Failed to copy ${src}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return makeResult(errors.length === 0, `Downloaded ${copied} files (${skipped} skipped, commit ${repo.commitSha})`, { commit: repo.commitSha, patterns, copied, skipped, errors: errors.length > 0 ? errors : undefined });
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[mcp-git-fetcher] MCP server running on stdio");
+}
+main().catch((e) => {
+    console.error("[mcp-git-fetcher] Fatal error:", e);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+export interface GitFetcherConfig {
+    /** GitLab repository URL (HTTP/HTTPS) */
+    repoUrl: string;
+    /** GitLab personal access token */
+    authToken?: string;
+    /** Local cache directory for cloned repositories */
+    cacheDir: string;
+    /** Branch to pull from */
+    branch: string;
+    /** Subdirectory name for skills in the repo */
+    skillsSubdir: string;
+    /** Subdirectory name for rules in the repo */
+    rulesSubdir: string;
+    /** Optional HTTP proxy */
+    httpProxy?: string;
+    /** Optional HTTPS proxy */
+    httpsProxy?: string;
+}
+export interface SyncTargets {
+    targetSkillsDir: string;
+    targetRulesDir: string;
+}
+export declare function loadConfig(): GitFetcherConfig;
+/**
+ * Build repo URL with embedded token for authentication.
+ * Transforms: http://host/repo.git → http://token@host/repo.git
+ */
+export declare function getAuthRepoUrl(config: GitFetcherConfig): string;
+export declare function getGitEnv(config: GitFetcherConfig): Record<string, string>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,UAAU,IAAI,gBAAgB,CAW7C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAU/D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK1E"}

package/dist/config.js

@@ -0,0 +1,47 @@
+import { config as dotenvConfig } from "dotenv";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+// Load .env from project root and ~/.mcp-git-fetcher/.env
+dotenvConfig();
+const homeEnvPath = join(homedir(), ".mcp-git-fetcher", ".env");
+if (existsSync(homeEnvPath)) {
+    dotenvConfig({ path: homeEnvPath });
+}
+export function loadConfig() {
+    return {
+        repoUrl: process.env.GIT_REPO_URL ?? "",
+        authToken: process.env.GIT_AUTH_TOKEN,
+        cacheDir: process.env.CACHE_DIR ?? join(homedir(), ".mcp-git-fetcher", "cache"),
+        branch: process.env.GIT_BRANCH ?? "main",
+        skillsSubdir: process.env.SKILLS_SUBDIR ?? "skills",
+        rulesSubdir: process.env.RULES_SUBDIR ?? "rules",
+        httpProxy: process.env.HTTP_PROXY,
+        httpsProxy: process.env.HTTPS_PROXY,
+    };
+}
+/**
+ * Build repo URL with embedded token for authentication.
+ * Transforms: http://host/repo.git → http://token@host/repo.git
+ */
+export function getAuthRepoUrl(config) {
+    if (!config.authToken)
+        return config.repoUrl;
+    if (config.repoUrl.includes("@"))
+        return config.repoUrl;
+    const idx = config.repoUrl.indexOf("://");
+    if (idx === -1)
+        return config.repoUrl;
+    const protocol = config.repoUrl.slice(0, idx + 3);
+    const rest = config.repoUrl.slice(idx + 3);
+    return `${protocol}${config.authToken}@${rest}`;
+}
+export function getGitEnv(config) {
+    const env = {};
+    if (config.httpProxy)
+        env.HTTP_PROXY = config.httpProxy;
+    if (config.httpsProxy)
+        env.HTTPS_PROXY = config.httpsProxy;
+    return env;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAgB,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,0DAA0D;AAC1D,YAAY,EAAE,CAAC;AACf,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAChE,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACtC,CAAC;AA0BD,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE;QACvC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACrC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,OAAO,CAAC;QAC/E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,MAAM;QACxC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,QAAQ;QACnD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO;QAChD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;QACjC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAC7C,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAExD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3C,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAwB;IAChD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;IACxD,IAAI,MAAM,CAAC,UAAU;QAAE,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/file-sync.d.ts

@@ -0,0 +1,21 @@
+export interface SyncResult {
+    copied: number;
+    skipped: number;
+    errors: string[];
+    sourceDir?: string;
+    targetDir?: string;
+}
+/**
+ * Recursively sync files from source to target.
+ *
+ * - Creates target dir if missing
+ * - Copies files that don't exist at destination
+ * - Skips files with identical SHA-256
+ * - Overwrites files with different content
+ */
+export declare function syncDirectory(srcDir: string, dstDir: string): SyncResult;
+/**
+ * Sync both skills/ and rules/ directories from the repo root.
+ */
+export declare function syncAll(repoRoot: string, skillsSubdir: string, rulesSubdir: string, targetSkillsDir?: string, targetRulesDir?: string): Record<string, SyncResult>;
+//# sourceMappingURL=file-sync.d.ts.map

package/dist/file-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sync.d.ts","sourceRoot":"","sources":["../src/file-sync.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CA8DxE;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EACxB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAgB5B"}

package/dist/file-sync.js

@@ -0,0 +1,97 @@
+import { createHash } from "crypto";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync } from "fs";
+import { dirname, join, relative } from "path";
+/**
+ * Compute SHA-256 hash of a file's contents.
+ */
+function fileHash(filePath) {
+    const hash = createHash("sha256");
+    const content = readFileSync(filePath);
+    hash.update(content);
+    return hash.digest("hex");
+}
+/**
+ * Recursively sync files from source to target.
+ *
+ * - Creates target dir if missing
+ * - Copies files that don't exist at destination
+ * - Skips files with identical SHA-256
+ * - Overwrites files with different content
+ */
+export function syncDirectory(srcDir, dstDir) {
+    const result = {
+        copied: 0,
+        skipped: 0,
+        errors: [],
+        sourceDir: srcDir,
+        targetDir: dstDir,
+    };
+    if (!existsSync(srcDir)) {
+        result.errors.push(`Source directory not found: ${srcDir}`);
+        return result;
+    }
+    mkdirSync(dstDir, { recursive: true });
+    function walk(current) {
+        const entries = readdirSync(current);
+        for (const entry of entries) {
+            const srcFile = join(current, entry);
+            let stat;
+            try {
+                stat = statSync(srcFile);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                walk(srcFile);
+                continue;
+            }
+            const relPath = relative(srcDir, srcFile);
+            const dstFile = join(dstDir, relPath);
+            // Create parent directory
+            mkdirSync(dirname(dstFile), { recursive: true });
+            // Check if destination exists with same content
+            if (existsSync(dstFile)) {
+                try {
+                    if (fileHash(srcFile) === fileHash(dstFile)) {
+                        result.skipped++;
+                        continue;
+                    }
+                }
+                catch {
+                    // Fall through to copy
+                }
+            }
+            try {
+                copyFileSync(srcFile, dstFile);
+                result.copied++;
+            }
+            catch (e) {
+                const msg = `Failed to copy ${srcFile} → ${dstFile}: ${e instanceof Error ? e.message : String(e)}`;
+                result.errors.push(msg);
+            }
+        }
+    }
+    walk(srcDir);
+    return result;
+}
+/**
+ * Sync both skills/ and rules/ directories from the repo root.
+ */
+export function syncAll(repoRoot, skillsSubdir, rulesSubdir, targetSkillsDir, targetRulesDir) {
+    const results = {};
+    if (targetSkillsDir) {
+        results.skills = syncDirectory(join(repoRoot, skillsSubdir), targetSkillsDir);
+    }
+    else {
+        results.skills = { copied: 0, skipped: 0, errors: ["target_skills_dir not provided"], sourceDir: join(repoRoot, skillsSubdir) };
+    }
+    if (targetRulesDir) {
+        results.rules = syncDirectory(join(repoRoot, rulesSubdir), targetRulesDir);
+    }
+    else {
+        results.rules = { copied: 0, skipped: 0, errors: ["target_rules_dir not provided"], sourceDir: join(repoRoot, rulesSubdir) };
+    }
+    return results;
+}
+//# sourceMappingURL=file-sync.js.map

package/dist/file-sync.js.map

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

package/dist/git-ops.d.ts

@@ -0,0 +1,21 @@
+import { GitFetcherConfig } from "./config.js";
+export declare class GitOperationError extends Error {
+    constructor(message: string);
+}
+export interface RepoHandle {
+    repoRoot: string;
+    commitSha: string;
+}
+/**
+ * Ensure the repository is cloned and up-to-date.
+ *
+ * - cacheDir doesn't exist → git clone
+ * - cacheDir exists with .git → git pull (with hard reset fallback)
+ */
+export declare function ensureRepo(config: GitFetcherConfig): Promise<RepoHandle>;
+/**
+ * List all files recursively under a subdirectory of the repo root.
+ * Returns absolute paths. Returns empty array if subdir doesn't exist.
+ */
+export declare function listSubdirFiles(repoRoot: string, subdir: string): string[];
+//# sourceMappingURL=git-ops.d.ts.map

package/dist/git-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../src/git-ops.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAA6B,MAAM,aAAa,CAAC;AAO1E,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+C9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAwB1E"}

package/dist/git-ops.js

@@ -0,0 +1,85 @@
+import { existsSync, mkdirSync, readdirSync, statSync } from "fs";
+import { join } from "path";
+import simpleGitModule from "simple-git";
+import { getAuthRepoUrl, getGitEnv } from "./config.js";
+// simple-git ESM compatibility: default export is callable, cast to avoid TS friction
+const createGit = simpleGitModule;
+export class GitOperationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GitOperationError";
+    }
+}
+/**
+ * Ensure the repository is cloned and up-to-date.
+ *
+ * - cacheDir doesn't exist → git clone
+ * - cacheDir exists with .git → git pull (with hard reset fallback)
+ */
+export async function ensureRepo(config) {
+    const cacheDir = config.cacheDir;
+    const gitDir = join(cacheDir, ".git");
+    if (!config.repoUrl) {
+        throw new GitOperationError("GIT_REPO_URL is not configured. Set the GIT_REPO_URL environment variable.");
+    }
+    const authUrl = getAuthRepoUrl(config);
+    const env = getGitEnv(config);
+    if (existsSync(gitDir)) {
+        console.error(`[mcp-git-fetcher] Repository cache exists at ${cacheDir}, pulling latest...`);
+        const git = createGit(cacheDir);
+        await git.fetch();
+        const currentBranch = (await git.branch()).current;
+        try {
+            await git.pull("origin", currentBranch, { "--ff-only": null });
+        }
+        catch {
+            console.error("[mcp-git-fetcher] Fast-forward failed, doing hard reset...");
+            await git.reset(["--hard", `origin/${currentBranch}`]);
+        }
+        const log = await git.log({ maxCount: 1 });
+        return {
+            repoRoot: cacheDir,
+            commitSha: log.latest?.hash.slice(0, 8) ?? "unknown",
+        };
+    }
+    console.error(`[mcp-git-fetcher] Cloning repository to ${cacheDir}...`);
+    mkdirSync(cacheDir, { recursive: true });
+    // Clone via the module directly (no cwd) then re-attach
+    const tempGit = createGit();
+    await tempGit.clone(authUrl, cacheDir, ["--branch", config.branch]);
+    const repo = createGit(cacheDir);
+    const log = await repo.log({ maxCount: 1 });
+    const commitSha = log.latest?.hash.slice(0, 8) ?? "unknown";
+    console.error(`[mcp-git-fetcher] Cloned at commit ${commitSha}`);
+    return { repoRoot: cacheDir, commitSha };
+}
+/**
+ * List all files recursively under a subdirectory of the repo root.
+ * Returns absolute paths. Returns empty array if subdir doesn't exist.
+ */
+export function listSubdirFiles(repoRoot, subdir) {
+    const dir = join(repoRoot, subdir);
+    if (!existsSync(dir))
+        return [];
+    const results = [];
+    function walk(current) {
+        const entries = readdirSync(current);
+        for (const entry of entries) {
+            const full = join(current, entry);
+            try {
+                if (statSync(full).isDirectory()) {
+                    walk(full);
+                }
+                else {
+                    results.push(full);
+                }
+            }
+            catch {
+                // Permission or race — skip
+            }
+        }
+    }
+    walk(dir);
+    return results;
+}
+//# sourceMappingURL=git-ops.js.map

package/dist/git-ops.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "mcp-git-fetcher",
+  "version": "0.1.0",
+  "description": "MCP server to fetch skills/rules files from internal GitLab repositories",
+  "type": "module",
+  "bin": {
+    "mcp-git-fetcher": "./dist/cli.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublish": "tsc",
+    "start": "node dist/cli.js"
+  },
+  "keywords": [
+    "mcp",
+    "gitlab",
+    "skills",
+    "rules",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "simple-git": "^3.27.0",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.0",
+    "typescript": "^5.8.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/mcp-git-fetcher"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}