@node-in-layers/core-knowledge-mcp 1.0.0

package/README.md

@@ -0,0 +1,7 @@
+# Development Mcp Tool for Node in Layers Core
+Whenever you build a system using node in layers core, you can use this MCP tool to teach the AI how to actually interact and work with your node in layers system.
+
+## How To Use
+```bash
+npx install @node-in-layers/core-knowledge-mcp
+```

package/bin/build.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+set -e
+
+# Build parent core package so we can embed it
+npm --prefix .. run build
+
+rm -Rf ./dist
+
+# Bundle built core into local node_modules for runtime self-containment
+rm -Rf ./node_modules/@node-in-layers/core
+mkdir -p ./node_modules/@node-in-layers/core
+cp -R ../dist/* ./node_modules/@node-in-layers/core/
+
+npm run tsc -- -p ./tsconfig.json
+node - <<'NODE'
+const fs = require('fs');
+const corePkg = JSON.parse(fs.readFileSync('../package.json','utf8'));
+const mcpPkg = JSON.parse(fs.readFileSync('./package.json','utf8'));
+mcpPkg.version = corePkg.version;
+mcpPkg.dependencies = mcpPkg.dependencies || {};
+mcpPkg.dependencies['@node-in-layers/core'] = corePkg.version;
+fs.mkdirSync('./dist', { recursive: true });
+fs.writeFileSync('./dist/package.json', JSON.stringify(mcpPkg, null, 2));
+NODE
+cp README.md ./dist
+cp -R ./bin/ ./dist/
+cp ./config.prod.mjs ./dist/
+rm ./dist/bin/build.sh
+
+sed -i -e 's/..\/dist\//..\//g' ./dist/bin/mcp_server.js

package/bin/mcp_server.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+
+import esMain from 'es-main'
+import { ArgumentParser } from 'argparse'
+import * as core from '@node-in-layers/core'
+import * as config from '../dist/config.prod.mjs'
+
+const _parseArguments = () => {
+  const parser = new ArgumentParser({
+    description: 'Starts the MCP server.',
+  })
+  return parser.parse_args()
+}
+
+const startServer = async () => {
+  const context = (await core.loadSystem({
+    environment: 'prod',
+    config: config.default(),
+  }))
+  await context.mcp.mcp.start()
+}
+
+if (esMain(import.meta)) {
+  const args = _parseArguments()
+  startServer(args.environment).catch((error) => {
+    console.error('Failed to start the server:', error)
+    process.exit(1)
+  })
+}

package/bin/shell.mts

@@ -0,0 +1,77 @@
+#!/usr/bin/env tsx
+
+import invoke from 'lodash/invoke.js'
+import esMain from 'es-main'
+import { ArgumentParser } from 'argparse'
+import repl from 'repl'
+import chalk from 'chalk'
+import merge from 'lodash/merge.js'
+import { queryBuilder } from 'functional-models'
+import * as core from '@node-in-layers/core'
+import { System } from '../src/types.js'
+
+const _parseArguments = () => {
+  const parser = new ArgumentParser({
+    description: 'Starts a shell environment into the system.',
+  })
+  parser.add_argument('environment', {
+    help: 'The environment for the service.',
+  })
+  parser.add_argument('-c', '--command', {
+    help: 'A dot path command to run',
+  })
+  parser.add_argument('-d', '--data', {
+    help: 'Stringified JSON data to pass to the command',
+  })
+  return parser.parse_args()
+}
+
+const _systemStartup = async environment => {
+  return core.loadSystem({
+    environment,
+  }) as unknown as System
+}
+
+const help = objects => () => {
+  console.info(chalk.white.bold(`You have access to the following objects:`))
+  console.info(chalk.white.bold(`[${Object.keys(objects).join(', ')}]`))
+  console.info()
+  console.info(
+    chalk.white.bold('You can also write "help()" to see this again.')
+  )
+}
+
+const runCommand = async (objects, command, data) => {
+  return invoke(objects, command, data)
+}
+
+const main = async () => {
+  const args = _parseArguments()
+  const objects = { ...(await _systemStartup(args.environment)), queryBuilder }
+  process.on('SIGINT', async function () {
+    await objects.services['@node-in-layers/data'].cleanup()
+    process.exit()
+  })
+  if (args.command) {
+    const result = await runCommand(
+      objects,
+      args.command,
+      args.data ? JSON.parse(args.data) : []
+    )
+    console.info(result)
+    process.exit()
+    return
+  }
+  const context = repl.start().context
+  const toUse = merge({ context: objects }, objects)
+  merge(context, objects, toUse)
+  console.info(chalk.blue.bold(`Welcome to the shell.`))
+  console.info(chalk.blue.bold(`--------------------------------`))
+  const helpFunc = help(toUse)
+  helpFunc()
+  context.help = helpFunc
+}
+
+if (esMain(import.meta)) {
+  main()
+}

package/config.prod.mjs

@@ -0,0 +1,61 @@
+import {
+  CoreNamespace,
+  LogFormat,
+  LogLevelNames,
+} from '@node-in-layers/core'
+import { McpNamespace } from '@node-in-layers/mcp-server'
+
+export default async () => {
+  return {
+    environment: 'prod',
+    systemName: '@node-in-layers/core/knowledge-mcp',
+    [CoreNamespace.root]: {
+      // @ts-ignore
+      apps: await Promise.all([
+        import(`@node-in-layers/mcp-server/index.js`),
+        import('./mcp/index.js'),
+        import('./knowledge/index.js'),
+      ]),
+      layerOrder: ['services', 'features', ['entries', 'mcp']],
+      logging: {
+        logLevel: LogLevelNames.trace,
+        logFormat: LogFormat.json,
+        // @ts-ignore
+        //customLogger: createCustomLogger(),
+        ignoreLayerFunctions: {
+          'amplify:services:getActiveGrowthAds': true,
+          'mongo.services.getMongoCollection': true,
+          'logs.features.searchRequests': true,
+          'auth.features': true,
+          'logging.services': true,
+          'logging.features': true,
+          'deepHelixAuth.services': true,
+          'deepHelixAuth.features.authMiddleware': true,
+          'mcp.mcp.addTool': true,
+          'mcp.mcp.addUnprotectedRoute': true,
+          'mcp.mcp.start': true,
+          'mcp.mcp.addFeature': true,
+          '@node-in-layers/data.express': true,
+          '@node-in-layers/data.services': true,
+          '@node-in-layers/data.features': true,
+          '@node-in-layers/rest-api/express.express': true,
+          '@node-in-layers/rest-api/express.features': true,
+          '@node-in-layers/rest-api/express.services': true,
+          '@node-in-layers/mcp-server.mcp': true,
+          'azure.services.discoverAzureStorageAccountAndKey': true,
+          'tasks.features.runFeatureTask': true,
+          'azure.express': true,
+          'api.express': true,
+        },
+      },
+    },
+    [McpNamespace]: {
+      server: {
+        connection: {
+          // @ts-ignore
+          type: 'cli',
+        },
+      },
+    },
+  }
+}

package/dist/README.md

@@ -0,0 +1,7 @@
+# Development Mcp Tool for Node in Layers Core
+Whenever you build a system using node in layers core, you can use this MCP tool to teach the AI how to actually interact and work with your node in layers system.
+
+## How To Use
+```bash
+npx install @node-in-layers/core-knowledge-mcp
+```

package/dist/bin/mcp_server.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+
+import esMain from 'es-main'
+import { ArgumentParser } from 'argparse'
+import * as core from '@node-in-layers/core'
+import * as config from '../config.prod.mjs'
+
+const _parseArguments = () => {
+  const parser = new ArgumentParser({
+    description: 'Starts the MCP server.',
+  })
+  return parser.parse_args()
+}
+
+const startServer = async () => {
+  const context = (await core.loadSystem({
+    environment: 'prod',
+    config: config.default(),
+  }))
+  await context.mcp.mcp.start()
+}
+
+if (esMain(import.meta)) {
+  const args = _parseArguments()
+  startServer(args.environment).catch((error) => {
+    console.error('Failed to start the server:', error)
+    process.exit(1)
+  })
+}

package/dist/bin/shell.mts

@@ -0,0 +1,77 @@
+#!/usr/bin/env tsx
+
+import invoke from 'lodash/invoke.js'
+import esMain from 'es-main'
+import { ArgumentParser } from 'argparse'
+import repl from 'repl'
+import chalk from 'chalk'
+import merge from 'lodash/merge.js'
+import { queryBuilder } from 'functional-models'
+import * as core from '@node-in-layers/core'
+import { System } from '../src/types.js'
+
+const _parseArguments = () => {
+  const parser = new ArgumentParser({
+    description: 'Starts a shell environment into the system.',
+  })
+  parser.add_argument('environment', {
+    help: 'The environment for the service.',
+  })
+  parser.add_argument('-c', '--command', {
+    help: 'A dot path command to run',
+  })
+  parser.add_argument('-d', '--data', {
+    help: 'Stringified JSON data to pass to the command',
+  })
+  return parser.parse_args()
+}
+
+const _systemStartup = async environment => {
+  return core.loadSystem({
+    environment,
+  }) as unknown as System
+}
+
+const help = objects => () => {
+  console.info(chalk.white.bold(`You have access to the following objects:`))
+  console.info(chalk.white.bold(`[${Object.keys(objects).join(', ')}]`))
+  console.info()
+  console.info(
+    chalk.white.bold('You can also write "help()" to see this again.')
+  )
+}
+
+const runCommand = async (objects, command, data) => {
+  return invoke(objects, command, data)
+}
+
+const main = async () => {
+  const args = _parseArguments()
+  const objects = { ...(await _systemStartup(args.environment)), queryBuilder }
+  process.on('SIGINT', async function () {
+    await objects.services['@node-in-layers/data'].cleanup()
+    process.exit()
+  })
+  if (args.command) {
+    const result = await runCommand(
+      objects,
+      args.command,
+      args.data ? JSON.parse(args.data) : []
+    )
+    console.info(result)
+    process.exit()
+    return
+  }
+  const context = repl.start().context
+  const toUse = merge({ context: objects }, objects)
+  merge(context, objects, toUse)
+  console.info(chalk.blue.bold(`Welcome to the shell.`))
+  console.info(chalk.blue.bold(`--------------------------------`))
+  const helpFunc = help(toUse)
+  helpFunc()
+  context.help = helpFunc
+}
+
+if (esMain(import.meta)) {
+  main()
+}

package/dist/config.prod.mjs

@@ -0,0 +1,61 @@
+import {
+  CoreNamespace,
+  LogFormat,
+  LogLevelNames,
+} from '@node-in-layers/core'
+import { McpNamespace } from '@node-in-layers/mcp-server'
+
+export default async () => {
+  return {
+    environment: 'prod',
+    systemName: '@node-in-layers/core/knowledge-mcp',
+    [CoreNamespace.root]: {
+      // @ts-ignore
+      apps: await Promise.all([
+        import(`@node-in-layers/mcp-server/index.js`),
+        import('./mcp/index.js'),
+        import('./knowledge/index.js'),
+      ]),
+      layerOrder: ['services', 'features', ['entries', 'mcp']],
+      logging: {
+        logLevel: LogLevelNames.trace,
+        logFormat: LogFormat.json,
+        // @ts-ignore
+        //customLogger: createCustomLogger(),
+        ignoreLayerFunctions: {
+          'amplify:services:getActiveGrowthAds': true,
+          'mongo.services.getMongoCollection': true,
+          'logs.features.searchRequests': true,
+          'auth.features': true,
+          'logging.services': true,
+          'logging.features': true,
+          'deepHelixAuth.services': true,
+          'deepHelixAuth.features.authMiddleware': true,
+          'mcp.mcp.addTool': true,
+          'mcp.mcp.addUnprotectedRoute': true,
+          'mcp.mcp.start': true,
+          'mcp.mcp.addFeature': true,
+          '@node-in-layers/data.express': true,
+          '@node-in-layers/data.services': true,
+          '@node-in-layers/data.features': true,
+          '@node-in-layers/rest-api/express.express': true,
+          '@node-in-layers/rest-api/express.features': true,
+          '@node-in-layers/rest-api/express.services': true,
+          '@node-in-layers/mcp-server.mcp': true,
+          'azure.services.discoverAzureStorageAccountAndKey': true,
+          'tasks.features.runFeatureTask': true,
+          'azure.express': true,
+          'api.express': true,
+        },
+      },
+    },
+    [McpNamespace]: {
+      server: {
+        connection: {
+          // @ts-ignore
+          type: 'cli',
+        },
+      },
+    },
+  }
+}