@revealui/mcp 0.1.0 → 0.1.3

package/dist/servers/revealui-stripe.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+/**
+ * RevealUI Stripe MCP Server
+ *
+ * Model Context Protocol server that exposes Stripe payment management tools
+ * scoped to RevealUI's subscription model. Gives AI agents structured access
+ * to customer, subscription, and payment intent data in RevealUI's Stripe account.
+ *
+ * Environment:
+ *   STRIPE_SECRET_KEY — Stripe secret key (sk_live_... or sk_test_...)
+ *
+ * Tools:
+ *   stripe_create_payment_intent  — Create a one-time payment intent
+ *   stripe_list_customers         — List customers, with optional email filter
+ *   stripe_get_customer           — Fetch a customer and their active subscription
+ *   stripe_list_subscriptions     — List subscriptions (all or by customer/status)
+ */
+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 { logger } from '@revealui/core/observability/logger';
+import { checkMcpLicense } from '../index.js';
+// ---------------------------------------------------------------------------
+// Stripe REST helpers
+// ---------------------------------------------------------------------------
+const STRIPE_BASE = 'https://api.stripe.com/v1';
+function stripeHeaders(secretKey) {
+    return {
+        Authorization: `Bearer ${secretKey}`,
+        'Content-Type': 'application/x-www-form-urlencoded',
+        'Stripe-Version': '2025-03-31.basil',
+        'User-Agent': 'RevealUI-MCP/1.0',
+    };
+}
+async function stripeGet(path, secretKey, params) {
+    const url = new URL(`${STRIPE_BASE}${path}`);
+    if (params) {
+        for (const [k, v] of Object.entries(params))
+            url.searchParams.set(k, v);
+    }
+    const res = await fetch(url.toString(), { headers: stripeHeaders(secretKey) });
+    const body = await res.json();
+    if (!res.ok)
+        throw new Error(body.error?.message ?? `Stripe ${res.status}`);
+    return body;
+}
+async function stripePost(path, secretKey, data) {
+    const res = await fetch(`${STRIPE_BASE}${path}`, {
+        method: 'POST',
+        headers: stripeHeaders(secretKey),
+        body: new URLSearchParams(data).toString(),
+    });
+    const body = await res.json();
+    if (!res.ok)
+        throw new Error(body.error?.message ?? `Stripe ${res.status}`);
+    return body;
+}
+// ---------------------------------------------------------------------------
+// Server
+// ---------------------------------------------------------------------------
+const server = new Server({ name: 'revealui-stripe', version: '1.0.0' }, { capabilities: { tools: {} } });
+const TOOLS = [
+    {
+        name: 'stripe_create_payment_intent',
+        description: 'Create a Stripe PaymentIntent for a one-time charge in RevealUI. ' +
+            'Amount is in the smallest currency unit (cents for USD).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                amount: {
+                    type: 'number',
+                    description: 'Amount in smallest currency unit (e.g. 2999 = $29.99)',
+                },
+                currency: {
+                    type: 'string',
+                    description: 'ISO 4217 currency code (default: usd)',
+                    default: 'usd',
+                },
+                customer_id: { type: 'string', description: 'Stripe customer ID to attach the payment to' },
+                description: { type: 'string', description: 'Human-readable description of the charge' },
+            },
+            required: ['amount'],
+        },
+    },
+    {
+        name: 'stripe_list_customers',
+        description: 'List Stripe customers in the RevealUI account. Optionally filter by email.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                email: { type: 'string', description: 'Filter by exact email address' },
+                limit: {
+                    type: 'number',
+                    description: 'Number of results (1-100, default: 20)',
+                    default: 20,
+                },
+            },
+        },
+    },
+    {
+        name: 'stripe_get_customer',
+        description: 'Fetch a Stripe customer by ID, including their active RevealUI subscription tier.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                customer_id: { type: 'string', description: 'Stripe customer ID (cus_...)' },
+            },
+            required: ['customer_id'],
+        },
+    },
+    {
+        name: 'stripe_list_subscriptions',
+        description: 'List Stripe subscriptions for RevealUI. Can filter by customer and/or status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                customer_id: { type: 'string', description: 'Filter to a specific customer (cus_...)' },
+                status: {
+                    type: 'string',
+                    description: 'Filter by status: active, canceled, past_due, trialing, all (default: active)',
+                    default: 'active',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Number of results (1-100, default: 20)',
+                    default: 20,
+                },
+            },
+        },
+    },
+];
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const secretKey = process.env.STRIPE_SECRET_KEY;
+    if (!secretKey) {
+        return {
+            content: [{ type: 'text', text: 'Error: STRIPE_SECRET_KEY is not set' }],
+            isError: true,
+        };
+    }
+    try {
+        switch (request.params.name) {
+            case 'stripe_create_payment_intent': {
+                const { amount, currency = 'usd', customer_id, description, } = request.params.arguments;
+                const data = {
+                    amount: String(Math.round(amount)),
+                    currency,
+                };
+                if (customer_id)
+                    data.customer = customer_id;
+                if (description)
+                    data.description = description;
+                const intent = await stripePost('/payment_intents', secretKey, data);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(intent, null, 2) }],
+                };
+            }
+            case 'stripe_list_customers': {
+                const { email, limit = 20 } = request.params.arguments;
+                const params = { limit: String(Math.min(limit, 100)) };
+                if (email)
+                    params.email = email;
+                const result = await stripeGet('/customers', secretKey, params);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'stripe_get_customer': {
+                const { customer_id } = request.params.arguments;
+                const [customer, subscriptions] = await Promise.all([
+                    stripeGet(`/customers/${customer_id}`, secretKey),
+                    stripeGet('/subscriptions', secretKey, {
+                        customer: customer_id,
+                        status: 'active',
+                        limit: '5',
+                        'expand[]': 'data.items.data.price.product',
+                    }),
+                ]);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ customer, subscriptions }, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'stripe_list_subscriptions': {
+                const { customer_id, status = 'active', limit = 20, } = request.params.arguments;
+                const params = {
+                    limit: String(Math.min(limit, 100)),
+                    status,
+                };
+                if (customer_id)
+                    params.customer = customer_id;
+                const result = await stripeGet('/subscriptions', secretKey, params);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Error: Unknown tool: ${request.params.name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (err) {
+        return {
+            content: [
+                { type: 'text', text: `Error: ${err instanceof Error ? err.message : String(err)}` },
+            ],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    if (!(await checkMcpLicense())) {
+        process.exit(1);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    logger.error('RevealUI Stripe MCP error', err instanceof Error ? err : new Error(String(err)));
+    process.exit(1);
+});
+//# sourceMappingURL=revealui-stripe.js.map

package/dist/servers/revealui-stripe.js.map

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

package/package.json

@@ -1,32 +1,71 @@
 {
   "name": "@revealui/mcp",
-  "version": "0.1.0",
-  "license": "SEE LICENSE IN ../../LICENSE.commercial",
+  "version": "0.1.3",
+  "description": "Model Context Protocol integrations for RevealUI — adapter framework, hypervisor, and MCP contracts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RevealUIStudio/revealui.git",
+    "directory": "packages/mcp"
+  },
+  "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "dotenv": "^17.2.4",
-    "@revealui/config": "0.2.0",
-    "@revealui/contracts": "1.0.0",
-    "@revealui/scripts": "0.1.0",
-    "@revealui/core": "0.2.0"
+    "@revealui/config": "0.3.0",
+    "@revealui/core": "0.5.0",
+    "@revealui/contracts": "1.3.1"
   },
   "devDependencies": {
-    "@electric-sql/pglite": "^0.3.15",
+    "@electric-sql/pglite": "^0.4.2",
     "pg": "^8.18.0",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "vitest": "^4.0.18"
   },
-  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapter": {
+      "types": "./dist/servers/adapter.d.ts",
+      "import": "./dist/servers/adapter.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts.d.ts",
+      "import": "./dist/contracts.js"
+    },
+    "./hypervisor": {
+      "types": "./dist/hypervisor.d.ts",
+      "import": "./dist/hypervisor.js"
+    },
+    "./db": {
+      "types": "./dist/adapters/db.d.ts",
+      "import": "./dist/adapters/db.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "funding": {
+    "type": "commercial",
+    "url": "https://revealui.com/pro"
+  },
+  "main": "./dist/index.js",
   "publishConfig": {
-    "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "type": "module",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
     "dev": "tsc --watch",
     "lint": "biome check .",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "typecheck": "tsc --noEmit"
   }
 }

package/.env.example

@@ -1,9 +0,0 @@
-MCP_PERSISTENCE_DRIVER=pglite
-ELECTRIC_DATABASE_URL=postgres://dev:dev@localhost:5432/revealui_mcp
-ELECTRIC_API_KEY=replace-me
-MCP_METRICS_MODE=logs
-PGVECTOR_ENABLED=false
-
-# Notes:
-# - Do NOT commit real credentials. Store real secrets in CI/Vault.
-# - Set `PGVECTOR_ENABLED=true` when using local Postgres with pgvector for vector testing.

package/MCP_MAINTENANCE.md

@@ -1,265 +0,0 @@
-# MCP Maintenance Guide
-
-This document consolidates all MCP-related maintenance information including CRDT audit strategy, key decisions, migration procedures, and metrics/observability approach.
-
----
-
-## Table of Contents
-
-1. [Decision Log](#decision-log)
-2. [CRDT Audit](#crdt-audit)
-3. [Migration Checklist](#migration-checklist)
-4. [Metrics & Observability](#metrics--observability)
-
----
-
-## Decision Log
-
-### MCP Decision — pglite (ElectricSQL) + Logs‑First Metrics
-
-**TL;DR** — Default to ElectricSQL (`pglite`) for local development to get Postgres parity, CRDT sync, and smooth production migration. Start observability with a logs‑first approach (`MCP_METRICS_MODE=logs`). Provide a documented migration path to managed Postgres + `pgvector` for production, and TODOs to add Prometheus + Grafana later.
-
-#### Why `pglite` (ElectricSQL)
-
-- Local Postgres parity: preserves SQL semantics developers expect while providing Electric sync.
-- CRDT & sync primitives: built-in conflict resolution and metadata for replicated state.
-- Smooth prod path: same logical model maps to managed Postgres (Neon / Supabase) with minimal code changes.
-
-#### Default configuration
-
-- `MCP_PERSISTENCE_DRIVER=pglite` (dev default)
-- `ELECTRIC_DATABASE_URL=` (placeholder for local pglite path/URL)
-- `MCP_METRICS_MODE=logs`
-
-#### Local vector testing
-
-- Use a compose variant with local Postgres + `pgvector` when testing vector queries or index behavior. `pglite` remains the default for state and CRDT behavior.
-
-#### Security stance
-
-- Never commit credentials. Use `packages/mcp/.env.example` with placeholders only.
-- Store `ELECTRIC_DATABASE_URL`, `ELECTRIC_API_KEY`, `PROD_DATABASE_URL` in CI secrets or Vault for staging/prod.
-
-#### Migration path (dev → prod)
-
-- Dev: `pglite` (local ElectricSQL)
-- Stage: Local Postgres with `pgvector` + Electric sync metadata
-- Prod: Managed Postgres (enable `pgvector`), Electric sync metadata preserved
-
-(See [Migration Checklist](#migration-checklist) section for a detailed plan.)
-
-#### Observability
-
-- Start with logs-first metrics (Option C). Emit structured log events for conflicts, merges, and error rates.
-- TODO: add Prometheus + Grafana manifests under `packages/mcp/k8s/` when operational budget permits.
-
-#### TODOs (short)
-
-- Add `packages/mcp/docker-compose.yml` with `pglite` dev service and `postgres+pgvector` variant.
-- Add `packages/mcp/src/adapters/db.ts` with `connectPglite()` / `connectPostgres()`.
-- Add CRDT migrations & backfill scripts.
-- Add integration tests that spin up compose and validate CRDT merges.
-- Add `packages/mcp/metrics.md` (logs-first) and TODOs for Option A (Prometheus + Grafana).
-
----
-
-## CRDT Audit
-
-### CRDT Audit — Candidate Entities & Strategy
-
-**Goal** — ensure all replicated, collaborative, or concurrent state uses CRDT semantics to avoid manual conflict resolution.
-
-#### Scope
-
-- Applies to MCP persistence: local `pglite` (dev) and managed Postgres (prod).
-- Targets entity categories that are concurrently updated or replicated.
-
-#### Candidate entities and recommended CRDT types
-
-- `documents` / `shared_documents`
-  - Use: collaborative edits
-  - CRDT: delta CRDT (RGA / JSON CRDT / operation-based)
-  - Policy: preserve operations and causal order
-- `subscription_state` / `cursors`
-  - Use: client offsets, cursors
-  - CRDT: LWW register or monotonic counter
-  - Policy: LWW with server-side monotonic enforcement where possible
-- `presence` / `ephemeral_status`
-  - Use: frequent transient updates
-  - CRDT: OR-Set with TTL or presence map
-  - Policy: TTL-based garbage collection
-- `message_ack` / `delivered_acks`
-  - Use: dedup across replicas
-  - CRDT: OR-Set or G-Set with tombstones
-  - Policy: idempotent ack addition, compact tombstones periodically
-- `user_settings` / `shared_settings`
-  - Use: small multi-client updates
-  - CRDT: observed-remove map / JSON CRDT
-  - Policy: field-level merge, operator override protected
-
-#### Implementation notes
-
-- Adapter responsibilities:
-  - `connectPglite()` should declare CRDT columns via Electric APIs (where available).
-  - `connectPostgres()` must keep Electric metadata columns and map CRDT metadata to Postgres-compatible storage.
-- Schema:
-  - Add `_electric_meta` or `_crdt_meta` columns near payloads.
-  - Store operation deltas if possible for efficient merges.
-- Rollout:
-  - Feature-flag per-entity CRDT enablement for staged rollout.
-  - Small-sample backfills prior to full backfill.
-- Storage & compaction:
-  - Implement delta compaction for large-delta CRDTs.
-  - Schedule periodic compaction jobs to remove tombstones and shrink op logs.
-
-#### Testing
-
-- Unit tests: CRDT op merges for each primitive (OR-Set, PNCounter, LWW register).
-- Integration tests: concurrent writers with `pglite` stack asserting deterministic merged state.
-- Migration tests: backfill scripts run on sample data and validate checksum diffs.
-
-#### Risk & mitigation
-
-- Existing payload types incompatible with CRDT fields — use non-destructive migrations and backfill.
-- Vector index (pgvector) mapping must be preserved during schema changes — treat embedding columns as orthogonal.
-
-#### Suggested tests to add
-
-- `packages/mcp/__tests__/crdt.unit.test.ts` — unit semantics.
-- `packages/mcp/__tests__/crdt.integration.test.ts` — compose-based concurrent writes.
-
----
-
-## Migration Checklist
-
-### MCP Migration Checklist — pglite → Managed Postgres + pgvector
-
-**Goal** — safely cut over from `pglite` dev workflows to managed Postgres in production while preserving CRDT semantics and vector index integrity.
-
-#### Pre‑reqs
-
-- Staging Postgres provisioned with `pgvector` enabled.
-- Backups and CI/Vault secrets available: `ELECTRIC_DATABASE_URL`, `ELECTRIC_API_KEY`, `PROD_DATABASE_URL`.
-- Smoke test harness and CRDT integration tests present.
-
-#### Ordered checklist
-
-1. **Backup source DB**
-```bash
-pg_dump -Fc -f backup.before.mcp.dump "$CURRENT_DB_URL"
-```
-
-2. **Provision staging DB with `pgvector`**
-```sql
-CREATE EXTENSION IF NOT EXISTS vector;
-```
-
-3. **Apply schema migrations to staging (include CRDT metadata columns)**
-- Add migration files: `packages/mcp/migrations/0001_add_crdt_columns.sql` and rollback script.
-
-4. **Small backfill (sample subset)**
-- Run `packages/mcp/migrations/backfill_crdt_meta.js` for representative rows; validate merges.
-
-5. **Run integration smoke tests**
-- Execute CRDT integration test suite against staging.
-
-6. **Export/import full snapshot (if migrating data)**
-```bash
-pg_restore -d "$STAGING_DB_URL" backup.before.mcp.dump
-```
-
-7. **Create `pgvector` indexes (maintenance window suggested)**
-```sql
-CREATE EXTENSION IF NOT EXISTS vector;
-CREATE INDEX IF NOT EXISTS documents_embedding_idx ON documents USING ivfflat (embedding vector_l2_ops) WITH (lists = 100);
-```
-
-8. **Full backfill & compaction**
-- Run full backfill; compact delta-CRDT ops as needed.
-
-9. **Switch app config (canary first)**
-- Set `MCP_PERSISTENCE_DRIVER=postgres`
-- Update `ELECTRIC_DATABASE_URL` to prod managed DB via secrets
-
-10. **Canary / canary tests**
-- Route small traffic, monitor conflict events and query correctness.
-
-11. **Full cutover**
-- Promote config change to all instances.
-
-12. **Post-migration validation**
-- Run full test suite, verify vector results, verify merge/conflict telemetry.
-
-13. **Rollback readiness**
-```bash
-pg_restore -d "$PROD_DB_URL" backup.before.mcp.dump
-```
-
-#### Operational notes
-
-- Prefer online migration with feature flags and small maintenance windows for index builds.
-- Validate checksums and sample-row diffs after every major migration step.
-- Keep rollback scripts next to each migration file.
-
----
-
-## Metrics & Observability
-
-### MCP Metrics & Observability — Logs‑First (Option C)
-
-#### Decision
-
-- Start with logs-first metrics to avoid hosted monitoring costs and reduce infra.
-- Emit structured logs for conflicts, merges, errors, and key latencies.
-- Provide clear TODOs and skeletons to add Prometheus + Grafana later.
-
-#### Env & modes
-
-- `MCP_METRICS_MODE=logs` (default)
-- Other modes: `otel` (collector), `prometheus` (future Option A)
-
-#### Structured log schema (recommended JSON fields)
-
-- `timestamp`
-- `service = "mcp"`
-- `event` = `conflict|merge|error|operation`
-- `entity` = `documents|cursors|presence|...`
-- `entity_id`
-- `op_type` = `write|merge|backfill|index`
-- `details` = short summary
-- `duration_ms`
-- `trace_id` (optional)
-
-#### Conflict/merge logging example (concept)
-
-- Log a `conflict` event when CRDT merge produces non-trivial resolution; include `before`, `ops_count`, `merged_summary`.
-
-#### Log collection options (free)
-
-- Use file logs + `loki` (self-hosted) and Grafana Loki datasource for queries (both OSS).
-- Or aggregate logs to a central file/CI artifact and analyze with `rg`/`jq` for small teams.
-
-#### Quick local setup (suggested)
-
-- Start compose with `loki` (optional) to collect logs, or rely on local file logs.
-```bash
-docker-compose -f packages/mcp/docker-compose.yml up -d loki
-```
-
-#### TODOs for Option A (Prometheus + Grafana)
-
-- Add `packages/mcp/k8s/` manifests and Helm chart scaffolding for Prometheus exporters and Grafana dashboards.
-- Instrument code with Prometheus client metrics (conflict counters, merge latencies).
-- Add dashboards and alert rules for high conflict rates.
-
-#### Implementation guidance
-
-- Implement `packages/mcp/src/telemetry.ts` that:
-  - Emits structured logs for every conflict/merge.
-  - In `MCP_METRICS_MODE=logs`, write JSON lines to stdout and rotate to file if needed.
-- Provide quick grep/jq scripts in `packages/mcp/` to extract conflict rates.
-
-#### Security & privacy
-
-- Avoid logging sensitive payloads (mask user PII).
-- Keep telemetry ingestion endpoints protected; local logs are preferred during dev.