agent-config-mcp 1.0.0

package/README.md

@@ -0,0 +1,41 @@
+# agent-config-mcp
+
+MCP server for syncing agent config (`.kiro/`) via Git. Changes are submitted as PRs for review.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `ac_init(repo)` | Clone agent config repo into `.kiro/` |
+| `ac_status` | Show sync status (changed files, ahead/behind) |
+| `ac_push(message?)` | Create branch → commit → push → open PR |
+| `ac_pull` | Pull latest from main |
+
+## Setup
+
+Add to your MCP config (`mcp.json`):
+
+```json
+{
+  "agent-config": {
+    "command": "npx",
+    "args": ["-y", "agent-config-mcp"]
+  }
+}
+```
+
+## First use
+
+Ask your agent to run `ac_init` with your config repo URL:
+
+```
+ac_init({ repo: "https://github.com/your-org/your-agent-config.git" })
+```
+
+This clones the repo into `.kiro/` of your current project. After that, `ac_push` and `ac_pull` work automatically.
+
+## Requirements
+
+- Node.js 18+
+- Git
+- GitHub CLI (`gh`) — for PR creation

package/index.js

@@ -0,0 +1,150 @@
+#!/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 { execFile } from "child_process";
+import { promisify } from "util";
+import { existsSync } from "fs";
+import { join } from "path";
+
+const exec = promisify(execFile);
+const CONFIG_DIR = ".kiro";
+
+function configPath() {
+  const cwd = process.cwd();
+  return join(cwd, CONFIG_DIR);
+}
+
+async function git(args, cwd) {
+  const { stdout, stderr } = await exec("git", args, { cwd });
+  return stdout.trim();
+}
+
+function isGitRepo(dir) {
+  return existsSync(join(dir, ".git"));
+}
+
+const server = new McpServer({
+  name: "agent-config-mcp",
+  version: "1.0.0",
+});
+
+// ac_status
+server.tool(
+  "ac_status",
+  "Show sync status of .kiro/ config directory",
+  {},
+  async () => {
+    const dir = configPath();
+    if (!existsSync(dir)) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: ".kiro/ directory not found" }) }] };
+    }
+    if (!isGitRepo(dir)) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: ".kiro/ is not a git repository. Run ac_init first." }) }] };
+    }
+    try {
+      const status = await git(["status", "--porcelain"], dir);
+      const log = await git(["log", "-1", "--format=%h %s (%cr)"], dir);
+      const remote = await git(["remote", "get-url", "origin"], dir);
+      let ahead = 0, behind = 0;
+      try {
+        await git(["fetch", "--quiet"], dir);
+        const ab = await git(["rev-list", "--left-right", "--count", "HEAD...@{u}"], dir);
+        [ahead, behind] = ab.split("\t").map(Number);
+      } catch {}
+      const files = status ? status.split("\n").map(l => l.trim()) : [];
+      return { content: [{ type: "text", text: JSON.stringify({
+        success: true, remote, lastCommit: log,
+        changed: files.length, files, ahead, behind
+      }) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: e.message }) }] };
+    }
+  }
+);
+
+// ac_pull
+server.tool(
+  "ac_pull",
+  "Pull latest changes from remote",
+  {},
+  async () => {
+    const dir = configPath();
+    if (!isGitRepo(dir)) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: ".kiro/ is not a git repository" }) }] };
+    }
+    try {
+      const result = await git(["pull", "--rebase"], dir);
+      return { content: [{ type: "text", text: JSON.stringify({ success: true, message: result || "Already up to date" }) }] };
+    } catch (e) {
+      if (e.message.includes("CONFLICT")) {
+        const conflicts = await git(["diff", "--name-only", "--diff-filter=U"], dir);
+        return { content: [{ type: "text", text: JSON.stringify({ success: false, error: "Conflict", conflicts: conflicts.split("\n") }) }] };
+      }
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: e.message }) }] };
+    }
+  }
+);
+
+// ac_push
+server.tool(
+  "ac_push",
+  "Create a branch, commit changes, push, and open a PR",
+  { message: z.string().optional().describe("Commit/PR message (auto-generated if omitted)") },
+  async ({ message }) => {
+    const dir = configPath();
+    if (!isGitRepo(dir)) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: ".kiro/ is not a git repository" }) }] };
+    }
+    try {
+      await git(["add", "-A"], dir);
+      const status = await git(["status", "--porcelain"], dir);
+      if (!status) {
+        return { content: [{ type: "text", text: JSON.stringify({ success: true, message: "No changes to push" }) }] };
+      }
+      const files = status.split("\n").map(l => l.trim());
+      const msg = message || `sync: ${files.map(f => f.slice(3)).join(", ")}`;
+      // Create branch, commit, push
+      const branch = `update/${Date.now()}`;
+      await git(["checkout", "-b", branch], dir);
+      await git(["commit", "-m", msg], dir);
+      await git(["push", "-u", "origin", branch], dir);
+      // Create PR via gh CLI
+      const { stdout: prUrl } = await exec("gh", ["pr", "create", "--title", msg, "--body", files.map(f => `- ${f.slice(3)}`).join("\n"), "--base", "main"], { cwd: dir });
+      // Return to main
+      await git(["checkout", "main"], dir);
+      return { content: [{ type: "text", text: JSON.stringify({
+        success: true, message: "PR created", pr: prUrl.trim(), branch, files: files.map(f => f.slice(3))
+      }) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: e.message }) }] };
+    }
+  }
+);
+
+// ac_init
+server.tool(
+  "ac_init",
+  "Clone agent config repo into .kiro/",
+  { repo: z.string().describe("Git repository URL") },
+  async ({ repo }) => {
+    const dir = configPath();
+    if (isGitRepo(dir)) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: ".kiro/ is already a git repository" }) }] };
+    }
+    try {
+      // If .kiro/ exists with files, back up first
+      if (existsSync(dir)) {
+        const backupDir = `${dir}.backup.${Date.now()}`;
+        await exec("mv", [dir, backupDir]);
+      }
+      await exec("git", ["clone", repo, CONFIG_DIR], { cwd: process.cwd() });
+      return { content: [{ type: "text", text: JSON.stringify({ success: true, message: `Cloned ${repo} into ${CONFIG_DIR}/` }) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: JSON.stringify({ success: false, error: e.message }) }] };
+    }
+  }
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "agent-config-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "bin": {
+    "agent-config-mcp": "./index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  }
+}