@ebowwa/tooling-mcp 0.1.0

package/README.md

@@ -0,0 +1,58 @@
+# @ebowwa/tooling-mcp
+
+HTTP MCP server for codespaces monorepo management.
+
+## Features
+
+- **Monorepo Status**: Get status of all repositories in the monorepo
+- **Repository Discovery**: List and discover all repositories
+- **Git Operations**: Get git status for any repository
+- **Sync Operations**: Sync single or all repositories
+
+## Installation
+
+```bash
+npm install @ebowwa/tooling-mcp
+```
+
+## Usage
+
+Start the MCP server (runs on port 8912 by default):
+
+```bash
+# Start with default port
+tooling-mcp
+
+# Start with custom port
+MCP_PORT=9000 tooling-mcp
+
+# Development mode
+bun run dev
+```
+
+## API
+
+### Health Check
+```
+GET http://localhost:8912/health
+```
+
+### MCP Endpoint
+```
+POST http://localhost:8912/mcp
+```
+
+Available tools:
+- `status` - Get status of all repos in the monorepo
+- `list_repos` - List all discovered repos
+- `get_repo_path` - Get filesystem path to a repo
+- `sync` - Sync all repos or a specific repo
+- `git_status` - Get detailed git status for a repo
+
+## Dependencies
+
+- [`@ebowwa/tooling`](https://www.npmjs.com/package/@ebowwa/tooling) - Core library for monorepo management
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,222 @@
+#!/usr/bin/env bun
+/**
+ * @ebowwa/tooling-mcp
+ *
+ * HTTP MCP server for codespaces monorepo management.
+ * Exposes tooling functionality via Model Context Protocol.
+ *
+ * Provides tools for:
+ * - Monorepo status across all repos
+ * - Git operations (status, sync)
+ * - Repository discovery and path resolution
+ *
+ * Runs on HTTP port 8912 by default (set MCP_PORT env var to change)
+ */
+
+import { StateManager } from "@ebowwa/tooling/src/state.js";
+import { SyncManager } from "@ebowwa/tooling/src/sync.js";
+import { getGitStatus } from "@ebowwa/tooling/src/git.js";
+import type { GitStatus } from "@ebowwa/tooling/src/git.js";
+
+const state = new StateManager();
+const sync = new SyncManager(state);
+
+// ==============
+// MCP Tools
+//=============
+
+/**
+ * Get status of all repos in the monorepo
+ */
+async function statusTool(): Promise<string> {
+  const statuses = await sync.getStatus();
+  const lines = [
+    "📊 Codespaces Monorepo Status",
+    "=" .repeat(40),
+    "",
+    `Phase: ${state.phase}`,
+    `Current repo: ${state.currentRepo || "none"}`,
+    "",
+    "Repos:",
+  ];
+
+  for (const [repo, status] of Object.entries(statuses)) {
+    const dirty = status.dirty ? " ⚠️ dirty" : "";
+    const behind = status.commitsBehind ? ` ↓${status.commitsBehind}` : "";
+    const ahead = status.commitsAhead ? ` ↑${status.commitsAhead}` : "";
+
+    lines.push(`  ${repo}:`);
+    lines.push(`    branch: ${status.branch}${dirty}${behind}${ahead}`);
+    lines.push(`    commit: ${status.lastCommit?.slice(0, 8) || "unknown"}`);
+  }
+
+  return lines.join("\n");
+}
+
+/**
+ * List all discovered repos
+ */
+async function listReposTool(): Promise<string> {
+  const lines = [
+    "📁 Discovered Repositories",
+    "=" .repeat(40),
+    "",
+  ];
+
+  for (const [name, remote] of Object.entries(state.remotes)) {
+    lines.push(`  ${name}:`);
+    lines.push(`    path: ${remote.path}`);
+    lines.push(`    url: ${remote.url}`);
+    lines.push(`    main branch: ${remote.mainBranch}`);
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+/**
+ * Get the filesystem path to a repo
+ */
+async function getRepoPathTool(repoName: string): Promise<string> {
+  try {
+    const path = state.getRepoPath(repoName);
+    return `Path to '${repoName}': ${path}`;
+  } catch (error) {
+    throw new Error(`Unknown repo: ${repoName}. Available repos: ${Object.keys(state.remotes).join(", ")}`);
+  }
+}
+
+/**
+ * Sync all repos or a specific repo
+ */
+async function syncTool(repo?: string): Promise<string> {
+  try {
+    let result;
+
+    if (repo) {
+      result = await sync.syncRepo(repo);
+      return `Synced ${repo}: ${result.synced ? "✓ success" : "✗ failed"}${result.error ? ` - ${result.error}` : ""}`;
+    } else {
+      result = await sync.syncAll();
+      const lines = ["🔄 Sync Results", ""];
+
+      for (const [name, r] of Object.entries(result.repos)) {
+        lines.push(`  ${r.synced ? "✓" : "✗"} ${name}`);
+      }
+
+      if (result.errors.length > 0) {
+        lines.push("", "Errors:");
+        result.errors.forEach(e => lines.push(`  - ${e}`));
+      }
+
+      return lines.join("\n");
+    }
+  } catch (error) {
+    throw new Error(`Sync failed: ${error}`);
+  }
+}
+
+/**
+ * Get detailed git status for a repo
+ */
+async function gitStatusTool(repoName: string): Promise<string> {
+  try {
+    const path = state.getRepoPath(repoName);
+    const status = await getGitStatus(path);
+
+    const lines = [
+      `📋 Git Status: ${repoName}`,
+      "=" .repeat(40),
+      "",
+      `Branch: ${status.branch}`,
+      `Dirty: ${status.dirty ? "Yes" : "No"}`,
+      `Commit: ${status.lastCommit || "unknown"}`,
+    ];
+
+    if (status.commitsBehind) {
+      lines.push(`Behind: ${status.commitsBehind} commits`);
+    }
+
+    if (status.commitsAhead) {
+      lines.push(`Ahead: ${status.commitsAhead} commits`);
+    }
+
+    return lines.join("\n");
+  } catch (error) {
+    throw new Error(`Failed to get git status for '${repoName}': ${error}`);
+  }
+}
+
+// ==============
+// MCP Server
+//=============
+
+// Simple SSE-based MCP server
+const MCP_PORT = parseInt(process.env.MCP_PORT || "8912");
+
+Bun.serve({
+  port: MCP_PORT,
+  fetch: async (req) => {
+    const url = new URL(req.url);
+
+    // Health check
+    if (url.pathname === "/health") {
+      return Response.json({ status: "ok", port: MCP_PORT });
+    }
+
+    // MCP endpoint
+    if (url.pathname === "/mcp") {
+      if (req.method === "POST") {
+        const body = await req.json();
+        const { tool, args } = body;
+
+        try {
+          let result;
+
+          switch (tool) {
+            case "status":
+              result = await statusTool();
+              break;
+            case "list_repos":
+              result = await listReposTool();
+              break;
+            case "get_repo_path":
+              result = await getRepoPathTool(args?.repo);
+              break;
+            case "sync":
+              result = await syncTool(args?.repo);
+              break;
+            case "git_status":
+              result = await gitStatusTool(args?.repo);
+              break;
+            default:
+              return Response.json({ error: `Unknown tool: ${tool}` }, { status: 400 });
+          }
+
+          return Response.json({ result });
+        } catch (error) {
+          return Response.json({ error: String(error) }, { status: 500 });
+        }
+      }
+
+      // GET returns available tools
+      return Response.json({
+        name: "tooling-mcp",
+        version: "0.1.0",
+        tools: [
+          { name: "status", description: "Get status of all repos in the monorepo" },
+          { name: "list_repos", description: "List all discovered repos" },
+          { name: "get_repo_path", description: "Get filesystem path to a repo", args: ["repo"] },
+          { name: "sync", description: "Sync all repos or a specific repo", args: ["repo?"] },
+          { name: "git_status", description: "Get detailed git status for a repo", args: ["repo"] },
+        ]
+      });
+    }
+
+    return Response.json({ error: "Not found" }, { status: 404 });
+  },
+});
+
+console.log(`🚀 Tooling MCP Server running on port ${MCP_PORT}`);
+console.log(`   Health: http://localhost:${MCP_PORT}/health`);
+console.log(`   MCP:    http://localhost:${MCP_PORT}/mcp`);

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ebowwa/tooling-mcp",
+  "version": "0.1.0",
+  "description": "HTTP MCP server for codespaces monorepo management - status, sync, and git operations",
+  "type": "module",
+  "main": "./index.ts",
+  "bin": {
+    "tooling-mcp": "./index.ts"
+  },
+  "scripts": {
+    "start": "bun run index.ts",
+    "dev": "MCP_PORT=8912 bun run index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "monorepo",
+    "git",
+    "sync",
+    "codespaces",
+    "tooling"
+  ],
+  "author": "Ebowwa Labs <labs@ebowwa.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/ebowwa/codespaces/tree/main/packages/src/tooling-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ebowwa/codespaces.git",
+    "directory": "packages/src/tooling-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/ebowwa/codespaces/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@ebowwa/tooling": "^0.3.1"
+  }
+}