@enfyra/mcp-server 0.0.94 → 0.0.95

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/mcp-server",
-  "version": "0.0.94",
+  "version": "0.0.95",
   "description": "MCP server for Enfyra - manage Enfyra instances from MCP-compatible coding tools",
   "type": "module",
   "license": "MIT",

package/src/mcp-server-entry.mjs

@@ -192,6 +192,21 @@ function getMetadataDatabaseContext(metadata, tables) {
 
 function summarizeTable(table) {
   if (!table) return null;
+  const relationFkColumnNames = new Set((table.relations || []).flatMap((relation) => {
+    const propertyName = relation.propertyName;
+    return propertyName
+      ? [
+          `${propertyName}Id`,
+          `${propertyName}_id`,
+          relation.fkCol,
+          relation.fkColumn,
+          relation.foreignKeyColumn,
+        ].filter(Boolean).map((name) => String(name).toLowerCase())
+      : [];
+  }));
+  const modelFacingColumns = (table.columns || []).filter((column) => (
+    column.isPrimary || !relationFkColumnNames.has(String(column.name || '').toLowerCase())
+  ));
   return {
     id: table.id ?? table._id,
     name: table.name,
@@ -199,7 +214,7 @@ function summarizeTable(table) {
     primaryKey: getPrimaryColumn(table)?.name || null,
     validateBody: table.validateBody,
     graphqlEnabled: table.graphqlEnabled,
-    columns: (table.columns || []).map((column) => ({
+    columns: modelFacingColumns.map((column) => ({
       id: column.id ?? column._id,
       name: column.name,
       type: column.type,
@@ -209,6 +224,7 @@ function summarizeTable(table) {
       isUpdatable: column.isUpdatable !== false,
       isEncrypted: column.isEncrypted === true,
     })),
+    hiddenRelationColumnCount: (table.columns || []).length - modelFacingColumns.length,
     relations: (table.relations || []).map((relation) => ({
       id: relation.id ?? relation._id,
       propertyName: relation.propertyName,
@@ -844,12 +860,21 @@ server.tool(
     tableName: z.string().optional().describe('Optional table name to summarize query fields and relation/deep capabilities.'),
   },
   async ({ tableName }) => {
-    const metadata = await discoveryFetch('/metadata');
-    const routesResult = await discoveryFetch('/enfyra_route?fields=path,mainTable.name,availableMethods.*,publicMethods.*,isEnabled&limit=1000');
-    const tables = normalizeTables(metadata);
+    const metadata = tableName
+      ? await discoveryFetch(`/metadata/${encodeURIComponent(tableName)}`)
+      : null;
+    const routesResult = tableName
+      ? await discoveryFetch('/enfyra_route?fields=path,mainTable.name,availableMethods.*,publicMethods.*,isEnabled&limit=1000')
+      : { data: [] };
+    const tableFromMetadata = tableName && !metadata?.error
+      ? metadata?.data?.table || metadata?.data || metadata?.table || metadata
+      : null;
+    const tables = tableName
+      ? (tableFromMetadata ? [tableFromMetadata] : [])
+      : [];
     const routes = summarizeRoutes(routesResult);
     const table = tableName ? tables.find((item) => item.name === tableName) : null;
-    const primaryKey = table ? getPrimaryColumn(table)?.name || 'id' : inferPrimaryKeyContext(tables).dominantPrimaryKey || 'id';
+    const primaryKey = table ? getPrimaryColumn(table)?.name || 'id' : 'id';
     const tableRoutes = tableName
       ? routes.filter((route) => route.mainTable === tableName)
       : [];
@@ -885,7 +910,9 @@ server.tool(
         ],
       },
       backendNotes: {
-        primaryKey: 'SQL commonly uses id; Mongo uses _id. Use table metadata primary column when available.',
+        primaryKey: tableName
+          ? 'Use this table metadata primary column when available.'
+          : 'SQL commonly uses id; Mongo uses _id. Use table metadata primary column when available.',
         relationNames: 'API relation operations use relation propertyName, not physical FK column names.',
         relationCascadeFkContract: 'When creating relations through create_table/create_relation/enfyra_table PATCH, never provide fkCol/fkColumn/foreignKeyColumn/sourceColumn/targetColumn/junction*Column. These are physical implementation details derived by Enfyra and hidden from app schema/forms.',
         graphql: 'GraphQL query args also accept filter/sort/page/limit, but GraphQL requires Bearer auth and table enablement via enfyra_graphql.',