@enfyra/mcp-server 0.0.6 → 0.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "MCP server for Enfyra - manage your Enfyra instance via Claude Code",
   "type": "module",
   "license": "MIT",

package/src/lib/mcp-instructions.js

@@ -65,6 +65,13 @@ export function buildMcpServerInstructions(apiBaseUrl) {
     '- **Error handling:** If redirected with `?error=`, show message to user.',
     '- **Do not confuse:** Google’s **Authorized redirect URI** = Enfyra **`redirectUri`** = `{ENFYRA_API_URL}/auth/google/callback`. **`appCallbackUrl`** = your SPA only (Enfyra redirects there *after* processing Google’s callback).',
     '',
+    '### System tables — which have REST routes',
+    '- **Not all system tables have a REST route.** `query_table`, `find_one_record`, `create_record`, etc. all go through the dynamic REST API and will return **404** if the table has no registered route.',
+    '- **`column_definition` has NO route** — do NOT call `query_table("column_definition", …)`. It will always 404.',
+    '- To check which tables are accessible via MCP tools, call `get_all_routes` and look for the route whose `mainTable.id` matches the table you need, or `get_all_metadata` to see all table names.',
+    '- **Tables confirmed to have REST routes (system):** `table_definition`, `route_definition`, `user_definition`, `setting_definition`, `ai_config_definition`, `role_definition`, `menu_definition`, `extension_definition`, `folder_definition`, `file_definition`, `file_permission_definition`, `package_definition`, `bootstrap_script_definition`, `storage_config_definition`, `ai_conversation_definition`, `ai_message_definition`, `websocket_definition`, `websocket_event_definition`, `oauth_config_definition`, `oauth_account_definition`, `method_definition`, `pre_hook_definition`, `post_hook_definition`, `route_handler_definition`, `route_permission_definition`.',
+    '- **Tables without REST routes (internal/system only):** `column_definition`, `relation_definition` — these are managed indirectly via `create_column`, `create_table`, or admin sync endpoints.',
+    '',
     '### Schema / table migration (sequential only)',
     '- When creating, updating, or deleting tables (or columns), run operations **one at a time**. The migration process locks the DB per operation.',
     '- Do NOT batch multiple schema changes (e.g. create 3 tables in parallel, or create table + add columns simultaneously). Execute each `create_table`, `create_column`, sync, or drop sequentially; wait for completion before the next.',

package/src/lib/table-tools.js

@@ -2,7 +2,7 @@
  * Table & Column tools for Enfyra MCP Server
  */
 import { z } from 'zod';
-import { fetchAPI, validateTableName } from './fetch.js';
+import { fetchAPI } from './fetch.js';
 
 /**
  * Register table tools with MCP server
@@ -24,7 +24,8 @@ export function registerTableTools(server, ENFYRA_API_URL) {
   server.tool(
     'create_table',
     [
-      'Create a new table definition. After creating a table, use create_column to add columns.',
+      'Create a new table definition with an auto-included `id` primary key column.',
+      'Use create_column to add more columns after creation.',
       'Schema operations (create/update/delete table, add column) must run one at a time — migration locks DB; parallel calls will fail.',
       'Enfyra auto-creates a REST route at path `/<table_name>` (same segment as `name`, not alias).',
       'REST surface for that route (matches server route engine): 4 HTTP operations — GET `/<table>` (list/filter), POST `/<table>` (create), PATCH `/<table>/:id` (update), DELETE `/<table>/:id` (delete).',
@@ -39,9 +40,10 @@ export function registerTableTools(server, ENFYRA_API_URL) {
       isEnabled: z.boolean().optional().default(true).describe('Enable table. Set to false to disable.'),
     },
     async ({ name, alias, description, isEnabled }) => {
+      const idColumn = { name: 'id', type: 'int', isPrimary: true, isGenerated: true, isNullable: false };
       const result = await fetchAPI(ENFYRA_API_URL, '/table_definition', {
         method: 'POST',
-        body: JSON.stringify({ name, alias, description, isEnabled }),
+        body: JSON.stringify({ name, alias, description, isEnabled, columns: [idColumn] }),
       });
       const base = ENFYRA_API_URL.replace(/\/$/, '');
       const routePath = `/${name}`;
@@ -55,6 +57,34 @@ export function registerTableTools(server, ENFYRA_API_URL) {
     }
   );
 
+  server.tool(
+    'create_relation',
+    [
+      'Create a relation between two tables (many-to-one, one-to-many, one-to-one, many-to-many).',
+      'For many-to-one: a FK column is created on the source table. For one-to-many: the FK is on the target (inverse relation).',
+      'Run sequentially — DB migration locks per operation.',
+    ].join(' '),
+    {
+      sourceTableId: z.string().describe('Source table ID (the table that owns the FK for many-to-one).'),
+      targetTableId: z.string().describe('Target table ID.'),
+      type: z.enum(['many-to-one', 'one-to-many', 'one-to-one', 'many-to-many']).describe('Relation type.'),
+      propertyName: z.string().describe('Property name on source table (e.g., "customer", "items").'),
+      inversePropertyName: z.string().optional().describe('Property name on target table for bidirectional relation (e.g., "orders").'),
+      isNullable: z.boolean().optional().default(true).describe('Whether the relation is nullable.'),
+      onDelete: z.enum(['CASCADE', 'SET NULL', 'RESTRICT', 'NO ACTION']).optional().default('SET NULL').describe('On delete behavior.'),
+    },
+    async ({ sourceTableId, targetTableId, type, propertyName, inversePropertyName, isNullable, onDelete }) => {
+      const relation = { type, propertyName, inversePropertyName: inversePropertyName || null, isNullable, onDelete };
+      const result = await fetchAPI(ENFYRA_API_URL, `/table_definition/${sourceTableId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ relations: [{ targetTableId, ...relation }] }),
+      });
+      return {
+        content: [{ type: 'text', text: `Relation created: ${propertyName} (${type}) from table ${sourceTableId} → ${targetTableId}.\n\nFull result:\n${JSON.stringify(result, null, 2)}` }],
+      };
+    }
+  );
+
   server.tool(
     'create_column',
     'Create a column for an existing table. Columns cascade through table_definition. Run schema changes sequentially — migration locks DB per operation.',