@rebasepro/mcp 0.0.1-canary.4829d6e

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rebase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# @rebasepro/mcp
+
+Model Context Protocol (MCP) server that exposes Rebase schema, database, document CRUD, user management, and dev server tools to AI assistants.
+
+## Installation
+
+```bash
+pnpm add @rebasepro/mcp
+```
+
+Or run directly:
+
+```bash
+npx rebase-mcp
+```
+
+## What This Package Does
+
+`@rebasepro/mcp` implements the [Model Context Protocol](https://modelcontextprotocol.io) over stdio, allowing AI assistants (Gemini, Claude, Cursor, etc.) to interact with a Rebase project. It provides tools and exposes collection definitions and generated schemas as MCP resources. It has native support for managing multiple local and remote projects.
+
+## Multi-Project Support
+
+The MCP server supports managing multiple Rebase projects simultaneously. This is ideal when working in an IDE with multiple open workspaces or when interacting with both local development servers and remote staging/production environments.
+
+- **Registry**: Project configurations are stored in `~/.rebase/projects.json`.
+- **Auto-Discovery**: If `rebase dev` is running locally, the MCP server automatically discovers the active development port and service key from `.rebase/state.json` inside the project directory, giving you **zero-config local development**.
+- **Default Project**: If no project registry exists, a default project named `default` is created using `REBASE_PROJECT_DIR` (or current working directory), `REBASE_BASE_URL`, and `REBASE_API_TOKEN`.
+
+## Configuration
+
+The server reads configuration from environment variables and `.env` files:
+
+| Variable | Default | Description |
+|---|---|---|
+| `REBASE_PROJECT_DIR` | `process.cwd()` | Project root directory (fallback if no registry) |
+| `REBASE_BASE_URL` | `http://localhost:3001` | Rebase backend URL (fallback if no registry) |
+| `REBASE_API_TOKEN` / `REBASE_TOKEN` | (empty) | Auth token for API calls (fallback if no registry) |
+
+The server attempts to load `.env` from `$REBASE_PROJECT_DIR/.env` or `$REBASE_PROJECT_DIR/app/.env`.
+
+---
+
+## Tools
+
+### Project Management Tools (6) [NEW]
+
+Manage multiple local projects or remote environments.
+
+| Tool | Required Args | Description |
+|---|---|---|
+| `rebase_project_list` | (none) | List all registered projects and show which one is currently active |
+| `rebase_project_switch` | `name` | Switch the active project to another registered project |
+| `rebase_project_add` | `name` | Register a new project (requires `baseUrl` and optional `projectDir`, `token`/`serviceKey`) |
+| `rebase_project_remove` | `name` | Remove a project from the registry (cannot remove the default project) |
+| `rebase_project_current` | (none) | Show details of the active project (name, directory, base URL, auth token status) |
+| `rebase_project_status` | (none) | Perform a health check on the active project's backend URL |
+
+### CLI Tools (6)
+
+Spawn `npx rebase <command>` in the active project directory.
+
+| Tool | Description |
+|---|---|
+| `rebase_schema_generate` | Generate Drizzle schema from collection definitions |
+| `rebase_db_push` | Apply schema directly to DB (dev shortcut) |
+| `rebase_schema_introspect` | Introspect live DB → collection definitions |
+| `rebase_db_generate` | Generate SQL migration files from schema diff |
+| `rebase_db_migrate` | Run pending SQL migrations |
+| `rebase_generate_sdk` | Generate typed TypeScript SDK |
+
+### Data Tools (5)
+
+CRUD operations via `@rebasepro/client` on the active project.
+
+| Tool | Required Args | Description |
+|---|---|---|
+| `list_documents` | `collection` | List with optional `limit`, `offset`, `orderBy`, `where` |
+| `get_document` | `collection`, `id` | Get single document by ID |
+| `create_document` | `collection`, `data` | Create a new document |
+| `update_document` | `collection`, `id`, `data` | Update existing document |
+| `delete_document` | `collection`, `id` | Delete a document |
+
+### Admin Tools (6)
+
+User and role management.
+
+| Tool | Required Args | Description |
+|---|---|---|
+| `list_users` | (none) | List all users with roles |
+| `create_user` | `email` | Create user (optional: `displayName`, `password`, `roles`) |
+| `update_user` | `userId` | Update user (optional: `email`, `displayName`, `roles`) |
+| `delete_user` | `userId` | Delete a user |
+| `list_roles` | (none) | List all defined roles |
+| `rebase_auth_reset_password` | `email` | Reset a user's password using the admin API (optional: `password`) |
+
+> [!NOTE]
+> `rebase_auth_reset_password` now calls the running admin endpoint instead of performing direct database queries. This makes it compatible with both local development and remote servers.
+
+### Dev Server Tools (3)
+
+Manage the local development server.
+
+| Tool | Description |
+|---|---|
+| `rebase_dev_start` | Start `pnpm run dev` in the `app/` directory |
+| `rebase_dev_logs` | Read recent output (default: 50 lines, max buffer: 500) |
+| `rebase_dev_stop` | Send SIGTERM to the dev server process |
+
+---
+
+## Resources
+
+The server exposes MCP resources for AI context:
+
+| URI | Description |
+|---|---|
+| `rebase://collections/{name}` | TypeScript source of a collection definition |
+| `rebase://schema` | Generated Drizzle schema (`schema.generated.ts`) |
+
+Collection files are discovered from `app/config/collections/`, `config/collections/`, or `collections/` under the active project directory.
+
+## Quick Start
+
+Add to your AI assistant's MCP config (e.g. `.gemini/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "rebase": {
+      "command": "npx",
+      "args": ["rebase-mcp"],
+      "env": {
+        "REBASE_PROJECT_DIR": "/path/to/your/project"
+      }
+    }
+  }
+}
+```
+
+## Related Packages
+
+- `@rebasepro/client` — Used internally for data and admin API calls
+

package/bin/rebase-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/index.js";

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export type PackageManager = "pnpm" | "yarn" | "npm";
+/**
+ * Detect the project's package manager by checking for lock files.
+ * Falls back to pnpm (Rebase's default) if no lock file is found.
+ */
+export declare function detectPackageManager(projectDir: string): PackageManager;
+/** Return the exec command and its arguments prefix for running a package binary. */
+export declare function getExecCommand(pm: PackageManager): {
+    command: string;
+    args: string[];
+};
+/** Return the run command for executing package.json scripts. */
+export declare function getRunCommand(pm: PackageManager): {
+    command: string;
+    args: string[];
+};
+/** Configuration for a single Rebase project. */
+export interface ProjectConfig {
+    name: string;
+    /** Absolute path to the project directory (for local projects). */
+    projectDir?: string;
+    /** Backend URL (e.g. http://localhost:3001 or https://staging.myapp.com). */
+    baseUrl: string;
+    /** Auth token — a service key, API key, or JWT. */
+    token: string;
+    /** ISO timestamp when the project was registered. */
+    addedAt: string;
+}
+export declare const server: Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare const ALL_TOOLS: ToolDef[];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAgBnE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAevE;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,EAAE,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAStF;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,EAAE,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CASrF;AAcD,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACnB;AA2QD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKlB,CAAC;AAIF,UAAU,OAAO;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACL;AA+bD,eAAO,MAAM,SAAS,EAAE,OAAO,EAS9B,CAAC"}