stackby-mcp-server 0.2.2 → 0.3.0

package/dist/stackby-api.d.ts

@@ -1,7 +1,3 @@
-/**
- * Stackby API client for MCP server.
- * Uses dedicated MCP API only: /api/v1/mcp/* (existing developer API is unchanged).
- */
 export declare function hasApiKey(): boolean;
 /** Returns the base URL actually in use (for error messages). */
 export declare function getApiBaseUrl(): string;
@@ -57,7 +53,7 @@ export interface DescribeTableResult {
     fields: TableField[];
     views: TableView[];
 }
-/** Describe one table: name (from tablelist), fields (columnlist), views (viewlist). */
+/** GET /api/v1/mcp/stacks/:stackId/tables/:tableId — describe table (single API: id, name, fields, views). */
 export declare function describeTable(stackId: string, tableId: string): Promise<DescribeTableResult>;
 export interface TableRecord {
     id: string;

package/dist/stackby-api.js

@@ -1,21 +1,35 @@
 /**
  * Stackby API client for MCP server.
  * Uses dedicated MCP API only: /api/v1/mcp/* (existing developer API is unchanged).
+ * In HTTP (hosted) mode, API key and URL come from request context; in stdio mode from process.env.
  */
-const BASE_URL = process.env.STACKBY_API_URL || "https://stackby.com";
-const API_KEY = process.env.STACKBY_API_KEY || "";
+import { getApiKeyFromContext, getApiUrlFromContext } from "./request-context.js";
+const DEFAULT_BASE_URL = process.env.STACKBY_API_URL || "https://stackby.com";
+const ENV_API_KEY = process.env.STACKBY_API_KEY || "";
 const MCP_API = "/api/v1/mcp";
+function getEffectiveApiKey() {
+    const fromContext = getApiKeyFromContext();
+    if (fromContext)
+        return fromContext;
+    return ENV_API_KEY.trim();
+}
+function getEffectiveBaseUrl() {
+    const fromContext = getApiUrlFromContext();
+    if (fromContext)
+        return fromContext.replace(/\/$/, "");
+    return DEFAULT_BASE_URL.replace(/\/$/, "");
+}
 export function hasApiKey() {
-    return Boolean(API_KEY && API_KEY.trim().length > 0);
+    return Boolean(getEffectiveApiKey());
 }
 /** Returns the base URL actually in use (for error messages). */
 export function getApiBaseUrl() {
-    return BASE_URL.replace(/\/$/, "");
+    return getEffectiveBaseUrl();
 }
 function authHeaders() {
-    const key = API_KEY.trim();
+    const key = getEffectiveApiKey();
     if (!key) {
-        throw new Error("STACKBY_API_KEY is not set. Set it in your MCP config (e.g. Cursor mcp.json env).");
+        throw new Error("STACKBY_API_KEY is not set. Set it in your MCP config (e.g. Cursor mcp.json env) or send header X-Stackby-API-Key (hosted).");
     }
     return {
         "Content-Type": "application/json",
@@ -23,8 +37,19 @@ function authHeaders() {
         ...(key.startsWith("pat_") ? { Authorization: `Bearer ${key}` } : {}),
     };
 }
+/**
+ * Backend sendResponseAuthentication.js sends MCP routes as "plain": the raw payload
+ * (body.data) is sent, not { data: body.data }. So we accept both shapes.
+ */
+function normalizeResponse(body) {
+    if (body != null && typeof body === "object" && "data" in body && body.data !== undefined) {
+        return { data: body.data };
+    }
+    return { data: body };
+}
 async function request(path, options = {}) {
-    const url = path.startsWith("http") ? path : `${BASE_URL.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+    const base = getEffectiveBaseUrl();
+    const url = path.startsWith("http") ? path : `${base}${path.startsWith("/") ? path : `/${path}`}`;
     const res = await fetch(url, {
         ...options,
         headers: { ...authHeaders(), ...options.headers },
@@ -34,7 +59,7 @@ async function request(path, options = {}) {
         const msg = body?.error ?? body?.message ?? res.statusText;
         throw new Error(`Stackby API ${res.status}: ${msg}`);
     }
-    return body;
+    return normalizeResponse(body);
 }
 /** GET /api/v1/mcp/workspaces — list workspaces (MCP API only). */
 export async function getWorkspaces() {
@@ -91,19 +116,16 @@ export async function getTableViewList(stackId, tableId) {
     const out = await request(path, { method: "GET" });
     return Array.isArray(out.data) ? out.data : [];
 }
-/** Describe one table: name (from tablelist), fields (columnlist), views (viewlist). */
+/** GET /api/v1/mcp/stacks/:stackId/tables/:tableId — describe table (single API: id, name, fields, views). */
 export async function describeTable(stackId, tableId) {
-    const [tables, fields, views] = await Promise.all([
-        getTables(stackId),
-        getTableColumns(stackId, tableId),
-        getTableViewList(stackId, tableId),
-    ]);
-    const tableMeta = tables.find((t) => t.id === tableId);
+    const path = `${MCP_API}/stacks/${encodeURIComponent(stackId)}/tables/${encodeURIComponent(tableId)}`;
+    const out = await request(path, { method: "GET" });
+    const d = out.data;
     return {
-        id: tableId,
-        name: tableMeta?.name ?? tableId,
-        fields,
-        views,
+        id: d?.id ?? tableId,
+        name: d?.name ?? tableId,
+        fields: Array.isArray(d?.fields) ? d.fields : [],
+        views: Array.isArray(d?.views) ? d.views : [],
     };
 }
 /** GET /api/v1/mcp/stacks/:stackId/tables/:tableId/rows — list rows (MCP API). */

package/package.json

@@ -1,26 +1,44 @@
-{
-  "name": "stackby-mcp-server",
-  "version": "0.2.2",
-  "description": "MCP server for Stackby — list stacks, tables, records; create/update/delete rows and schema via AI clients (Cursor, Claude, Cline).",
-  "main": "dist/index.js",
-  "bin": { "stackby-mcp-server": "dist/index.js" },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsc && node -e \"console.log('\\nBuild OK. Output in dist/'); console.log('Run npm start to run the server.');\"",
-    "start": "node dist/index.js",
-    "dev": "tsc && node dist/index.js",
-    "prepare": "npm run build"
-  },
-  "engines": { "node": ">=18" },
-  "keywords": ["mcp", "stackby", "model-context-protocol", "cursor", "claude", "ai"],
-  "license": "MIT",
-  "type": "module",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "typescript": "^5.3.0"
-  }
-}
+{
+  "name": "stackby-mcp-server",
+  "version": "0.3.0",
+  "description": "MCP server for Stackby — list stacks, tables, records; create/update/delete rows and schema via AI clients (Cursor, Claude, Cline).",
+  "main": "dist/index.js",
+  "bin": {
+    "stackby-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && node -e \"console.log('\\nBuild OK. Output in dist/'); console.log('Run npm start to run the server.');\"",
+    "start": "node dist/index.js",
+    "start:http": "node dist/server-http.js",
+    "dev": "tsc && node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "stackby",
+    "model-context-protocol",
+    "cursor",
+    "claude",
+    "ai"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stackbyhq/stackby-mcp-server"
+  },
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}