@nup-white/nwdb-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NUP WHITE Inc.
+
+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,110 @@
+# @nup-white/nwdb-mcp
+
+Official MCP server for **NW DB** — the AI-native PostgreSQL DBaaS.
+
+[![npm](https://img.shields.io/npm/v/@nup-white/nwdb-mcp.svg)](https://www.npmjs.com/package/@nup-white/nwdb-mcp)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Connect Claude Code, Claude Desktop, Cursor, Continue (or any MCP client) to your NW DB workspace in 30 seconds.
+
+## What is NW DB?
+
+NW DB is "Supabase for AI agents." A managed PostgreSQL + pgvector DB with built-in cleansing/normalization/masking/embedding agents and an MCP-first API. Sign up at [nwdb.dev](https://nwdb.dev) — Hobby plan ¥5,000/month with 3-day free trial.
+
+## Quickstart
+
+### 1. Get an API key
+
+Sign up at [nwdb.dev](https://nwdb.dev), create a workspace, and copy your API key from `Settings → API Keys`.
+
+### 2a. Claude Code
+
+Add to `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "nwdb": {
+      "command": "npx",
+      "args": ["-y", "@nup-white/nwdb-mcp"],
+      "env": {
+        "NWDB_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### 2b. Claude Desktop
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "nwdb": {
+      "command": "npx",
+      "args": ["-y", "@nup-white/nwdb-mcp"],
+      "env": {
+        "NWDB_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### 2c. Cursor
+
+Settings → MCP → Add new server:
+
+```json
+{
+  "nwdb": {
+    "command": "npx",
+    "args": ["-y", "@nup-white/nwdb-mcp"],
+    "env": { "NWDB_API_KEY": "your-api-key-here" }
+  }
+}
+```
+
+### 3. Restart your client
+
+The 5 tools should appear: `list_tables`, `describe_table`, `query`, `insert`, `search_vectors`.
+
+## Tools
+
+| Tool | Description | Annotations |
+|---|---|---|
+| `list_tables` | List all tables in the workspace | `readOnly` |
+| `describe_table` | Get schema (columns + record count) | `readOnly` |
+| `query` | Query with filters / order / limit | `readOnly` |
+| `insert` | Insert a record | `destructive` |
+| `search_vectors` | Cosine-similarity vector search | `readOnly` |
+
+## Environment variables
+
+| Var | Required | Description |
+|---|---|---|
+| `NWDB_API_KEY` | yes | Workspace API key from [nwdb.dev/settings](https://nwdb.dev/settings) |
+| `NWDB_WORKSPACE` | no | Workspace ID (omit if your key is workspace-scoped) |
+| `NWDB_API_URL` | no | Override base URL (default: `https://api.nwdb.dev`) |
+
+## Pricing
+
+| Plan | Price | Includes |
+|---|---|---|
+| **Hobby** | ¥5,000/mo + usage | 100K req / 1GB / 1M tokens |
+| **Enterprise** | ¥100,000/mo + usage | SLA / VPC / CMEK / **white-label resale allowed** |
+
+Enterprise resellers can rebrand NW DB completely and charge up to **10× the base rate**. Contact [sales@nupwhite.com](mailto:sales@nupwhite.com).
+
+## Links
+
+- Website: [nwdb.dev](https://nwdb.dev)
+- Docs: [nwdb.dev/docs](https://nwdb.dev/docs)
+- GitHub: [github.com/nup-cloud/nw-db](https://github.com/nup-cloud/nw-db)
+- Discord: TBA
+
+## License
+
+MIT © NUP WHITE Inc.

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * NW DB — Official MCP Server
+ *
+ * stdio MCP server that proxies tool calls to api.nwdb.dev/api/v1/mcp/*.
+ * Designed for Claude Code, Claude Desktop, Cursor, Continue.
+ *
+ * Configuration via environment variables:
+ *   NWDB_API_KEY    (required)  workspace API key from https://nwdb.dev/settings
+ *   NWDB_WORKSPACE  (optional)  workspace ID (if your key is workspace-scoped you can omit this)
+ *   NWDB_API_URL    (optional)  override base URL (default: https://api.nwdb.dev)
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+/**
+ * NW DB — Official MCP Server
+ *
+ * stdio MCP server that proxies tool calls to api.nwdb.dev/api/v1/mcp/*.
+ * Designed for Claude Code, Claude Desktop, Cursor, Continue.
+ *
+ * Configuration via environment variables:
+ *   NWDB_API_KEY    (required)  workspace API key from https://nwdb.dev/settings
+ *   NWDB_WORKSPACE  (optional)  workspace ID (if your key is workspace-scoped you can omit this)
+ *   NWDB_API_URL    (optional)  override base URL (default: https://api.nwdb.dev)
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const API_URL = (process.env.NWDB_API_URL || "https://api.nwdb.dev").replace(/\/$/, "");
+const API_KEY = process.env.NWDB_API_KEY || "";
+const WORKSPACE_ID = process.env.NWDB_WORKSPACE || "";
+if (!API_KEY) {
+    console.error("[nwdb-mcp] NWDB_API_KEY environment variable is required.");
+    console.error("[nwdb-mcp] Get one at https://nwdb.dev/settings");
+    process.exit(1);
+}
+const TOOLS = [
+    {
+        name: "list_tables",
+        description: "List all tables in the NW DB workspace.",
+        inputSchema: { type: "object", properties: {}, required: [] },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    },
+    {
+        name: "describe_table",
+        description: "Get the schema (columns + record count) of a table.",
+        inputSchema: {
+            type: "object",
+            properties: { table: { type: "string", description: "Table name" } },
+            required: ["table"],
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    },
+    {
+        name: "query",
+        description: "Query records from a table with optional filters, ordering, and limit.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                table: { type: "string" },
+                filters: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            field: { type: "string" },
+                            operator: { type: "string", enum: ["=", "!=", "<", "<=", ">", ">=", "ILIKE"] },
+                            value: {},
+                        },
+                    },
+                },
+                orderBy: { type: "string" },
+                orderDirection: { type: "string", enum: ["asc", "desc"] },
+                limit: { type: "number" },
+            },
+            required: ["table"],
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    },
+    {
+        name: "insert",
+        description: "Insert a record into a table. Modifies state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                table: { type: "string" },
+                data: { type: "object" },
+            },
+            required: ["table", "data"],
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
+    },
+    {
+        name: "search_vectors",
+        description: "Cosine-similarity search over a vector collection.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                collection: { type: "string" },
+                embedding: { type: "array", items: { type: "number" } },
+                topK: { type: "number" },
+                minScore: { type: "number" },
+            },
+            required: ["collection", "embedding"],
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    },
+];
+async function callRemote(tool, args) {
+    const headers = {
+        "Content-Type": "application/json",
+        "X-API-Key": API_KEY,
+    };
+    if (WORKSPACE_ID)
+        headers["X-Workspace-ID"] = WORKSPACE_ID;
+    const res = await fetch(`${API_URL}/api/v1/mcp/call`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ tool, arguments: args ?? {} }),
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        throw new Error(`NW DB API ${res.status}: ${text}`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+async function main() {
+    const server = new Server({ name: "nwdb-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args } = req.params;
+        try {
+            const result = await callRemote(name, args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[nwdb-mcp] Connected to stdio. Awaiting tool calls.");
+}
+main().catch((err) => {
+    console.error("[nwdb-mcp] Fatal:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@nup-white/nwdb-mcp",
+  "version": "0.1.0",
+  "description": "Official MCP server for NW DB — AI-native PostgreSQL DBaaS. Connect Claude Code, Cursor, Continue, and any MCP client to your NW DB workspace.",
+  "license": "MIT",
+  "author": "NUP WHITE Inc.",
+  "homepage": "https://nwdb.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nup-cloud/nw-db.git",
+    "directory": "mcp-client"
+  },
+  "bugs": {
+    "url": "https://github.com/nup-cloud/nw-db/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "nwdb-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "cursor",
+    "anthropic",
+    "database",
+    "postgresql",
+    "dbaas",
+    "ai",
+    "nw-db",
+    "vector-search"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}