@enfyra/mcp-server 0.0.9 → 0.0.10

package/package.json

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

package/src/index.mjs

@@ -351,6 +351,109 @@ server.tool('login', 'Force login to Enfyra and get new tokens', {
   return { content: [{ type: 'text', text: `Logged in successfully!\nToken expires: ${new Date(getTokenExpiry()).toISOString()}` }] };
 });
 
+// ============================================================================
+// PACKAGE TOOLS
+// ============================================================================
+
+server.tool(
+  'search_npm',
+  'Search NPM registry for packages. Returns name, version, description for installation.',
+  {
+    query: z.string().describe('Package name or search term (e.g., "axios", "node-ssh", "dayjs")'),
+    limit: z.number().optional().default(5).describe('Max results (default: 5)'),
+  },
+  async ({ query, limit }) => {
+    const url = `https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(query)}&size=${limit}`;
+    const response = await fetch(url);
+    if (!response.ok) throw new Error(`NPM search failed: ${response.statusText}`);
+    const data = await response.json();
+
+    const packages = data.objects.map((obj) => ({
+      name: obj.package.name,
+      version: obj.package.version,
+      description: obj.package.description || '',
+    }));
+
+    return {
+      content: [{
+        type: 'text',
+        text: JSON.stringify({ packages, total: data.total }, null, 2),
+      }],
+    };
+  },
+);
+
+server.tool(
+  'install_package',
+  [
+    'Install an NPM package on Enfyra. Searches NPM registry for exact version, then creates package_definition record.',
+    'Enfyra handles the actual yarn add internally based on type.',
+    'Type "Server" = available in handlers/hooks as $ctx.$pkgs.packageName.',
+    'Type "App" = available in extensions via getPackages().',
+  ].join(' '),
+  {
+    name: z.string().describe('Exact NPM package name (e.g., "node-ssh", "axios")'),
+    type: z.enum(['Server', 'App']).default('Server').describe('Where to install: Server (handlers/hooks) or App (extensions)'),
+    version: z.string().optional().describe('Specific version. If omitted, fetches latest from NPM.'),
+  },
+  async ({ name, type, version }) => {
+    // Step 1: Get package info from NPM if version not specified
+    let pkgVersion = version;
+    let pkgDescription = '';
+
+    if (!pkgVersion) {
+      const npmUrl = `https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(name)}&size=5`;
+      const npmResponse = await fetch(npmUrl);
+      if (!npmResponse.ok) throw new Error(`NPM search failed: ${npmResponse.statusText}`);
+      const npmData = await npmResponse.json();
+
+      const exactMatch = npmData.objects.find((obj) => obj.package.name === name);
+      if (!exactMatch) throw new Error(`Package "${name}" not found on NPM`);
+
+      pkgVersion = exactMatch.package.version;
+      pkgDescription = exactMatch.package.description || '';
+    }
+
+    // Step 2: Check if already installed
+    const checkFilter = JSON.stringify({ name: { _eq: name } });
+    const existing = await fetchAPI(ENFYRA_API_URL, `/package_definition?filter=${encodeURIComponent(checkFilter)}&limit=1`);
+    if (existing.data && existing.data.length > 0) {
+      return {
+        content: [{
+          type: 'text',
+          text: `Package "${name}" is already installed (version: ${existing.data[0].version}, type: ${existing.data[0].type}).\n${JSON.stringify(existing.data[0], null, 2)}`,
+        }],
+      };
+    }
+
+    // Step 3: Get current user for installedBy
+    const me = await fetchAPI(ENFYRA_API_URL, '/me');
+    const userId = me.data?.[0]?.id || me.data?.[0]?._id;
+    if (!userId) throw new Error('Cannot get current user ID');
+
+    // Step 4: Install via package_definition
+    const body = {
+      name,
+      version: pkgVersion,
+      description: pkgDescription,
+      type,
+      installedBy: { id: userId },
+    };
+
+    const result = await fetchAPI(ENFYRA_API_URL, '/package_definition', {
+      method: 'POST',
+      body: JSON.stringify(body),
+    });
+
+    return {
+      content: [{
+        type: 'text',
+        text: `Package "${name}@${pkgVersion}" installed successfully (type: ${type}).\n${JSON.stringify(result, null, 2)}`,
+      }],
+    };
+  },
+);
+
 // ============================================================================
 // MENU & EXTENSION TOOLS
 // ============================================================================

package/src/lib/mcp-instructions.js

@@ -156,9 +156,13 @@ export function buildMcpServerInstructions(apiBaseUrl) {
     '- **type "page":** Full-page extension. Requires `menu: { id }` — create menu first (`create_menu` or `create_record` on `menu_definition`), find by path/label, then create extension with `menu: { id: menuId }`. `menu_definition` uses **label** not name — filter by `label` or `path`.',
     '- **type "widget":** Widget extension. No menu required. Embed via `<Widget :id="extensionId" />` in other extensions or pages.',
     '',
-    '#### NPM packages:',
-    '- Before using (e.g. dayjs, chart.js) — check `package_definition` (filter `type: App`, `name`, `isEnabled`). If not found, tell user to install via Settings → Packages.',
-    '- Use `getPackages([\'dayjs\'])` in code; call in `onMounted` or async handler.',
+    '#### NPM packages (install via MCP):',
+    '- **Use `install_package` tool** — just pass the package name and type. The tool auto-fetches version from NPM, checks if already installed, and creates the record.',
+    '- Example: `install_package({ name: "node-ssh", type: "Server" })` — that is all. Tool handles everything.',
+    '- **Search first with `search_npm`** if unsure of exact package name.',
+    '- **Server** packages → available as `$ctx.$pkgs.packageName` in handlers/hooks.',
+    '- **App** packages → available via `getPackages([\'dayjs\'])` in extensions (call in `onMounted`).',
+    '- **Do NOT use `create_record` on `package_definition` directly** — use `install_package` instead.',
     '',
     '#### Important patterns:',
     '- **useApi:** Must call `execute()` — does NOT auto-run. Supports batch operations with `ids` or `files` options.',