@nooriel/mcp-bridge 1.0.0

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@nooriel/mcp-bridge",
+  "version": "1.0.0",
+  "description": "MCP bridge for Nooriel — connects coding agents (Codex, Claude Code, Cursor, Windsurf, Kiro) to Nooriel's Build Instruction Pack via MCP protocol.",
+  "bin": {
+    "nooriel-mcp": "./server.mjs"
+  },
+  "type": "module",
+  "files": [
+    "server.mjs"
+  ],
+  "keywords": [
+    "mcp",
+    "nooriel",
+    "coding-agent",
+    "build-instructions",
+    "prototype",
+    "windsurf",
+    "cursor",
+    "claude-code",
+    "codex",
+    "kiro"
+  ],
+  "author": "Nooriel <hello@nooriel.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nooriel/nooriel-2.0-backend",
+    "directory": "mcp-bridge"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/server.mjs

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+/**
+ * Nooriel MCP Bridge — connects coding agents to Nooriel's Build Instruction Pack.
+ *
+ * This is a stdio-based MCP server that wraps Nooriel's REST API.
+ * Coding agents (Windsurf, Claude Code, Codex, Cursor) connect to this
+ * bridge via stdio, and it fetches data from Nooriel's backend.
+ *
+ * Usage:
+ *   NOORIEL_API_BASE=https://... NOORIEL_TOKEN=xxx node server.mjs
+ *
+ * Or via npx (once published):
+ *   npx @nooriel/mcp-bridge
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+const API_BASE = process.env.NOORIEL_API_BASE || "";
+const TOKEN = process.env.NOORIEL_TOKEN || "";
+
+if (!API_BASE || !TOKEN) {
+  console.error(
+    "Missing env vars. Set NOORIEL_API_BASE and NOORIEL_TOKEN.\n" +
+    "Example:\n" +
+    '  NOORIEL_API_BASE="https://nooriel-backend-293682423253.us-central1.run.app/mcp/v1/projects/YOUR_PROJECT_ID" \\\n' +
+    '  NOORIEL_TOKEN="your_mcp_token" \\\n' +
+    "  node server.mjs"
+  );
+  process.exit(1);
+}
+
+async function apiFetch(path) {
+  const url = `${API_BASE}${path}`;
+  const res = await fetch(url, {
+    headers: { "X-MCP-Token": TOKEN },
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`API ${res.status}: ${text}`);
+  }
+  return res.json();
+}
+
+// Create MCP server
+const server = new McpServer({
+  name: "nooriel",
+  version: "1.0.0",
+});
+
+// ── Tools ──────────────────────────────────────────────
+
+server.tool(
+  "get_build_pack",
+  "Get the Build Instruction Pack — list of all 13 instruction files and metadata. Call this first.",
+  {},
+  async () => {
+    const data = await apiFetch("/build-pack");
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "get_build_pack_file",
+  "Get a single instruction file by filename (e.g., '00-MASTER-PROMPT.md')",
+  {
+    filename: { type: "string", description: "Filename from the pack (e.g., '00-MASTER-PROMPT.md')" },
+  },
+  async ({ filename }) => {
+    const data = await apiFetch(`/build-pack/files/${encodeURIComponent(filename)}`);
+    return { content: [{ type: "text", text: data.content || JSON.stringify(data) }] };
+  }
+);
+
+server.tool(
+  "get_all_files",
+  "Get ALL 13 instruction files in one call. Returns the complete Build Instruction Pack.",
+  {},
+  async () => {
+    const data = await apiFetch("/build-pack/all");
+    // Format as readable text with file separators
+    let text = `# Build Instruction Pack: ${data.project_name}\n\n`;
+    for (const [name, content] of Object.entries(data.files || {})) {
+      text += `\n---\n## ${name}\n\n${content}\n`;
+    }
+    return { content: [{ type: "text", text }] };
+  }
+);
+
+server.tool(
+  "get_project_context",
+  "Get a high-level project summary — name, stage, progress.",
+  {},
+  async () => {
+    const data = await apiFetch("/context");
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+);
+
+server.tool(
+  "report_progress",
+  "Report build progress to the founder. Call this periodically.",
+  {
+    current_task: { type: "string", description: "What you're currently working on" },
+    files_created: { type: "string", description: "Comma-separated list of files created so far" },
+  },
+  async ({ current_task, files_created }) => {
+    const res = await fetch(`${API_BASE}/build-pack/progress`, {
+      method: "POST",
+      headers: { "X-MCP-Token": TOKEN, "Content-Type": "application/json" },
+      body: JSON.stringify({ current_task, files_created: files_created || "" }),
+    });
+    const data = await res.json();
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+  }
+);
+
+server.tool(
+  "report_complete",
+  "Signal that the build is complete. Include the commit SHA if you pushed to GitHub.",
+  {
+    summary: { type: "string", description: "Brief summary of what was built" },
+    commit_sha: { type: "string", description: "Git commit SHA (optional)" },
+  },
+  async ({ summary, commit_sha }) => {
+    const res = await fetch(`${API_BASE}/build-pack/complete`, {
+      method: "POST",
+      headers: { "X-MCP-Token": TOKEN, "Content-Type": "application/json" },
+      body: JSON.stringify({ summary: summary || "", commit_sha: commit_sha || "" }),
+    });
+    const data = await res.json();
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+  }
+);
+
+// ── Resources ──────────────────────────────────────────
+
+server.resource(
+  "nooriel://build-pack",
+  "nooriel://build-pack",
+  async (uri) => {
+    const data = await apiFetch("/build-pack/all");
+    let text = `# Build Instruction Pack: ${data.project_name}\n\n`;
+    for (const [name, content] of Object.entries(data.files || {})) {
+      text += `\n---\n## ${name}\n\n${content}\n`;
+    }
+    return { contents: [{ uri: uri.href, text, mimeType: "text/markdown" }] };
+  }
+);
+
+// ── Start ──────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);