@restforgejs/mcp-server 1.2.0

package/dist/tools/setup/update-env.js

@@ -0,0 +1,176 @@
+import { z } from 'zod';
+import { readFile, writeFile, access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { parseEnvFile, serializeEnvFile, mergeEnvEntries, isSensitiveKey, maskValue, } from '../../lib/env-parser.js';
+export function registerSetupUpdateEnv(server) {
+    server.registerTool('setup_update_env', {
+        title: 'Update Database Connection Env',
+        description: `Apply a partial update to config/db-connection.env. Accepts an arbitrary set of key/value pairs and merges them into the existing file, preserving comments, blank lines, and untouched parameters.
+
+USE WHEN:
+- Toggling individual feature flags (e.g. LIVE_SYNC_ENABLED, REDIS_ENABLED, KAFKA_ENABLED)
+- Adjusting one or two values without restating the whole core connection
+- Adding a new optional parameter that is not in the template
+
+DO NOT USE FOR:
+- Generating the initial config skeleton -> use 'setup_init_config'
+- Bulk write of license + DB credentials -> use 'setup_write_env'
+- Validating connection -> use 'setup_validate_config'
+
+Behavior: read existing file, replace matching keys (preserving inline comments), append non-existing keys at the bottom, write back. Values may be string, number, or boolean (booleans serialize as 'true'/'false'). Values containing spaces, '=' or '#' are auto-quoted.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. If the user writes in Indonesian, respond in Indonesian.
+- Never mention internal tool names in the reply to the user. Describe actions by what they do (e.g. "set up the initial config", "fill in the credentials", "validate the connection").
+- Speak in plain language. Summarise the result by counting and naming the changed keys; do not paste the full diff block unless the user explicitly asks.
+- Do not echo sensitive values (license keys, passwords) into chat even when they appear masked in the response. Confirm presence and length only.
+- When a precondition is not met (e.g. config file is missing), frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z.string().min(1).describe('Absolute path of the project folder'),
+            configFile: z
+                .string()
+                .default('db-connection.env')
+                .describe('Config file name in the config/ folder. Default: db-connection.env'),
+            fields: z
+                .record(z.string(), z.union([z.string(), z.number(), z.boolean()]))
+                .refine((obj) => Object.keys(obj).length > 0, {
+                message: 'fields must contain at least one key',
+            })
+                .describe('Key-value map of parameters to update or add. Example: { "DB_PORT": 5433, "KAFKA_ENABLED": true }'),
+        },
+        annotations: {
+            title: 'Update Env Config',
+            readOnlyHint: false,
+            idempotentHint: true,
+        },
+    }, async ({ cwd, configFile, fields }) => {
+        const projectCwd = resolve(cwd);
+        const envPath = join(projectCwd, 'config', configFile);
+        // Precondition check: the config file must exist before it can be updated.
+        // Treated as a non-error precondition per the authoring guide §3.4.
+        try {
+            await access(envPath);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the configuration file does not exist yet.
+
+Project path: ${projectCwd}
+Expected file: ${envPath}
+
+For the assistant:
+- The user is trying to update a configuration that has not been created yet.
+- Suggest generating the initial RESTForge configuration first, then retry the update.
+- When explaining to the user, say something like "the configuration file isn't there yet — should I set up the initial config first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        // Real I/O failure on read: surface as error per §3.4.
+        let existingContent;
+        try {
+            existingContent = await readFile(envPath, 'utf-8');
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to read the configuration file before applying the update.
+
+Project path: ${projectCwd}
+File: ${envPath}
+Reason: ${msg}
+
+For the assistant:
+- Tell the user that the configuration file exists but could not be read.
+- Summarise the likely cause (permissions, file lock, encoding) in plain language; do not paste the raw error unless the user explicitly asks.
+- Offer to retry once the underlying issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const existingEntries = parseEnvFile(existingContent);
+        const merged = mergeEnvEntries(existingEntries, fields);
+        const newContent = serializeEnvFile(merged.entries);
+        // Real I/O failure on write: surface as error per §3.4.
+        try {
+            await writeFile(envPath, newContent, 'utf-8');
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to write the updated configuration to disk.
+
+Project path: ${projectCwd}
+File: ${envPath}
+Reason: ${msg}
+
+For the assistant:
+- Tell the user that the update could not be persisted.
+- Summarise the likely cause (permissions, disk full, file lock) in plain language; do not paste the raw error unless the user explicitly asks.
+- The original file is unchanged. Offer to retry once the underlying issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Success: labeled facts + fenced change summary per §3.5.
+        const formatChange = (key, before, after) => {
+            if (isSensitiveKey(key)) {
+                return `  - ${key}: ${maskValue(before)} -> ${maskValue(after)}`;
+            }
+            return `  - ${key}: ${before} -> ${after}`;
+        };
+        const formatAdd = (key, value) => {
+            const v = isSensitiveKey(key) ? maskValue(value) : value;
+            return `  - ${key}=${v}`;
+        };
+        const changeBlockLines = [
+            `Updated fields (${merged.updated.length}):`,
+            ...(merged.updated.length === 0
+                ? ['  (none)']
+                : merged.updated.map((u) => formatChange(u.key, u.before, u.after))),
+            '',
+            `Added fields (${merged.added.length}):`,
+            ...(merged.added.length === 0
+                ? ['  (none)']
+                : merged.added.map((a) => formatAdd(a.key, a.value))),
+            '',
+            `Unchanged fields (${merged.unchanged.length}): preserved`,
+        ];
+        const sensitiveTouched = merged.updated.some((u) => isSensitiveKey(u.key)) ||
+            merged.added.some((a) => isSensitiveKey(a.key));
+        const text = `Configuration updated successfully.
+
+Project path: ${projectCwd}
+File: ${envPath}
+Updated keys: ${merged.updated.length}
+Added keys: ${merged.added.length}
+Unchanged keys: ${merged.unchanged.length}
+
+--- Changes ---
+${changeBlockLines.join('\n')}
+--- end Changes ---
+
+For the assistant:
+- Confirm to the user that the configuration was updated.
+- Summarise in plain language: how many keys were changed and added, and name the most relevant ones (without listing every single one unless asked).
+- Do not paste the full change block unless the user explicitly asks.
+- ${sensitiveTouched
+            ? 'A sensitive value (license or password) was changed or added. Do NOT echo the new value into chat. Confirm only that it was set.'
+            : 'No sensitive values were changed in this update.'}
+- Suggest validating the configuration as the next step. Do not mention internal tool names.`;
+        return { content: [{ type: 'text', text }] };
+    });
+}
+//# sourceMappingURL=update-env.js.map

package/dist/tools/setup/update-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-env.js","sourceRoot":"","sources":["../../../src/tools/setup/update-env.ts"],"names":[],"mappings":"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"}

package/dist/tools/setup/validate-config.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSetupValidateConfig(server: McpServer): void;

package/dist/tools/setup/validate-config.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerSetupValidateConfig(server) {
+    server.registerTool('setup_validate_config', {
+        title: 'Validate RESTForge Config',
+        description: `Validate the RESTForge license and connections to database, redis, and kafka based on the config file.
+
+USE WHEN:
+- The db-connection.env file has been filled in (license + DB credentials)
+- After credentials have been written or updated, to verify they actually work
+- Before starting runtime or codegen operations
+- Verifying license and access to external services before deploy
+- Diagnosing configuration issues
+- The user asks things like "test connection", "cek license", "validate config",
+  "apakah config sudah benar", "is the database reachable", "tes koneksi",
+  "verify the configuration", "cek apakah license valid"
+- Before validating, consider calling 'setup_read_env' to confirm what is
+  currently set — especially when the user describes the validation relative
+  to a recent change (e.g. "cek apakah license barunya valid"). // per §5.3
+- The user wants to validate CONFIGURATION (license, database connection, kafka, redis), not payload files
+
+DO NOT USE FOR:
+- Writing the config file -> use 'setup_write_env'
+- Adjusting individual fields -> use 'setup_update_env'
+- Generating module code -> use codegen_* domain tools
+- Checking if payload JSON files are still in sync with the database schema -> use 'codegen_validate_payload'
+
+Often called as the final step after 'setup_write_env' or 'setup_update_env'
+has filled in or changed credentials, to confirm that they actually work. // per §5.2
+
+This tool runs: npx restforge validate --config=<configFile> in the given cwd.
+This tool is READ-ONLY and safe to call repeatedly.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. If the user writes in Indonesian, respond in Indonesian.
+- Never mention internal tool names in the reply to the user. Describe actions by what they do (e.g. "fill in the credentials", "update a single value", "set up the initial config").
+- Speak in plain language. Summarise the validation result by component (license, database, optional redis/kafka); do not paste the raw CLI output unless the user explicitly asks.
+- The CLI output may contain license fragments, host names, or user names. Do not echo license keys, passwords, or full connection URIs into chat. Confirm validation status only.
+- When a precondition is not met (e.g. config file is missing), frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z.string().min(1).describe('Absolute path of the project folder'),
+            configFile: z
+                .string()
+                .default('db-connection.env')
+                .describe('Config file name in the config/ folder. Default: db-connection.env'),
+        },
+        annotations: {
+            title: 'Validate Config',
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    }, async ({ cwd, configFile }) => {
+        const projectCwd = resolve(cwd);
+        const configPath = join(projectCwd, 'config', configFile);
+        // Precondition check: the config file must exist before it can be validated.
+        // Treated as a non-error precondition per the authoring guide §3.4.
+        try {
+            await access(configPath);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the configuration file does not exist yet.
+
+Project path: ${projectCwd}
+Expected file: ${configPath}
+
+For the assistant:
+- The user is trying to validate a configuration that has not been created and filled in yet.
+- Suggest generating the initial RESTForge configuration first, then filling in the license and database credentials, and finally retrying the validation.
+- When explaining to the user, say something like "there's no configuration to validate yet — should I set up the initial config first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false, // per §3.4
+            };
+        }
+        const result = await execProcess('npx', ['restforge', 'validate', `--config=${configFile}`], { cwd: projectCwd, timeout: 30_000 });
+        // Validation failure: real error per §3.4; structured per §3.5.
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Configuration validation did not pass.
+
+Project path: ${projectCwd}
+Config file: ${configPath}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout || '(empty)'}
+
+stderr:
+${result.stderr || '(empty)'}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user that the validation reported one or more problems.
+- Summarise the likely failing component in plain language (license, database, redis, kafka) based on the CLI output; do not paste the raw stdout/stderr unless the user explicitly asks.
+- Do not echo license keys, passwords, or full connection URIs from the output into chat.
+- Suggest reviewing or updating the relevant credentials and retrying. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true, // per §3.4
+            };
+        }
+        // Success: one-line summary + labeled facts + fenced raw output per §3.5.
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Configuration validation passed.
+
+Project path: ${projectCwd}
+Config file: ${configPath}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+${result.stdout || '(empty)'}
+--- end CLI output ---
+
+For the assistant:
+- Confirm to the user that the license and external connections checked out.
+- Summarise in plain language which components were checked and passed (license, database, optional redis/kafka), based on what appears in the CLI output.
+- Do not paste the raw CLI output unless the user explicitly asks. Do not echo license keys or credentials. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=validate-config.js.map

package/dist/tools/setup/validate-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.js","sourceRoot":"","sources":["../../../src/tools/setup/validate-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qIAiCkH;QAC/H,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YACtE,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,OAAO,CAAC,mBAAmB,CAAC;iBAC5B,QAAQ,CAAC,oEAAoE,CAAC;SAClF;QACD,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;SACrB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE1D,6EAA6E;QAC7E,oEAAoE;QACpE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;iBACT,UAAU;;;;;8KAKmJ;qBACjK;iBACF;gBACD,OAAO,EAAE,KAAK,EAAE,WAAW;aAC5B,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,KAAK,EACL,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,UAAU,EAAE,CAAC,EACnD,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CACrC,CAAC;QAEF,gEAAgE;QAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;eACX,UAAU;WACd,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM,IAAI,SAAS;;;EAG1B,MAAM,CAAC,MAAM,IAAI,SAAS;;;;;;;2GAO+E;qBAC9F;iBACF;gBACD,OAAO,EAAE,IAAI,EAAE,WAAW;aAC3B,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;eACX,UAAU;WACd,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;EAG1B,MAAM,CAAC,MAAM,IAAI,SAAS;;;;;;gJAMoH;iBACrI;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/setup/write-env.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSetupWriteEnv(server: McpServer): void;

package/dist/tools/setup/write-env.js

@@ -0,0 +1,168 @@
+import { z } from 'zod';
+import { readFile, writeFile, access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { parseEnvFile, serializeEnvFile, mergeEnvEntries, } from '../../lib/env-parser.js';
+export function registerSetupWriteEnv(server) {
+    server.registerTool('setup_write_env', {
+        title: 'Write Database Connection Env',
+        description: `Write license, server settings, and database credentials into config/db-connection.env using a partial-merge strategy that preserves all other parameters and comments in the file.
+
+USE WHEN:
+- The user provides a complete set of license + database credentials in one go
+- The user is doing initial credential setup (first time filling in the empty template)
+- You need to fill in or update ALL core connection fields together (license, 
+  server, database) — even if some values are already set, this tool will 
+  overwrite them consistently
+- The user says things like "isi credentials", "setup koneksi database", 
+  "fill in the connection info", "atur license dan database"
+
+DO NOT USE FOR:
+- Generating the initial config skeleton -> use 'setup_init_config'
+- Changing only one or two fields (e.g. just the password, or toggle a flag) -> use 'setup_update_env'
+- Validating license/connection -> use 'setup_validate_config'
+
+Behavior: read existing file, update LICENSE/SERVER_*/DB_* entries in place, append any missing keys at the bottom, and write back. Comments, blank lines, and unrelated parameters are preserved verbatim. Output file: <cwd>/config/db-connection.env.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. If the user writes in Indonesian, respond in Indonesian.
+- Never mention internal tool names in the reply to the user. Describe actions by what they do (e.g. "set up the initial config", "update a single value", "validate the connection").
+- Speak in plain language. Summarise what was written; do not paste the full field list unless the user explicitly asks.
+- Do not echo sensitive values (license keys, passwords) into chat even when they appear masked in the response. Confirm only that they were set.
+- When a precondition is not met (e.g. config file is missing), frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z.string().min(1).describe('Absolute path of the project folder'),
+            license: z
+                .string()
+                .regex(/^[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/, 'Format must be XXXX-XXXX-XXXX-XXXX'),
+            serverAddress: z.string().default('127.0.0.1'),
+            serverPort: z.number().int().min(1).max(65535).default(3000),
+            dbType: z.enum(['postgresql', 'mysql', 'oracle', 'sqlite']),
+            dbHost: z.string().min(1),
+            dbPort: z.number().int().min(1).max(65535),
+            dbUser: z.string().min(1),
+            dbPassword: z.string(),
+            dbName: z.string().min(1),
+        },
+        annotations: {
+            title: 'Write Env Config',
+            readOnlyHint: false,
+            idempotentHint: true,
+        },
+    }, async (args) => {
+        const projectCwd = resolve(args.cwd);
+        const configDir = join(projectCwd, 'config');
+        const envPath = join(configDir, 'db-connection.env');
+        // Precondition check: the config file must exist before it can be written.
+        // Treated as a non-error precondition per the authoring guide §3.4.
+        try {
+            await access(envPath);
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the configuration file does not exist yet.
+
+Project path: ${projectCwd}
+Expected file: ${envPath}
+
+For the assistant:
+- The user is trying to write credentials into a configuration that has not been created yet.
+- Suggest generating the initial RESTForge configuration first, then retry filling in the credentials.
+- When explaining to the user, say something like "the configuration file isn't there yet — should I set up the initial config first?". Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        // Real I/O failure on read: surface as error per §3.4.
+        let existingContent;
+        try {
+            existingContent = await readFile(envPath, 'utf-8');
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to read the configuration file before applying the credentials.
+
+Project path: ${projectCwd}
+File: ${envPath}
+Reason: ${msg}
+
+For the assistant:
+- Tell the user that the configuration file exists but could not be read.
+- Summarise the likely cause (permissions, file lock, encoding) in plain language; do not paste the raw error unless the user explicitly asks.
+- Offer to retry once the underlying issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const fields = {
+            LICENSE: args.license,
+            SERVER_ADDRESS: args.serverAddress,
+            SERVER_PORT: args.serverPort,
+            DB_TYPE: args.dbType,
+            DB_HOST: args.dbHost,
+            DB_PORT: args.dbPort,
+            DB_USER: args.dbUser,
+            DB_PASSWORD: args.dbPassword,
+            DB_NAME: args.dbName,
+        };
+        const existingEntries = parseEnvFile(existingContent);
+        const merged = mergeEnvEntries(existingEntries, fields);
+        const newContent = serializeEnvFile(merged.entries);
+        // Real I/O failure on write: surface as error per §3.4.
+        try {
+            await writeFile(envPath, newContent, 'utf-8');
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to write the credentials to the configuration file.
+
+Project path: ${projectCwd}
+File: ${envPath}
+Reason: ${msg}
+
+For the assistant:
+- Tell the user that the credentials could not be saved.
+- Summarise the likely cause (permissions, disk full, file lock) in plain language; do not paste the raw error unless the user explicitly asks.
+- The original file is unchanged. Offer to retry once the underlying issue is resolved. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Success: labeled facts + masked summary per §3.5.
+        const updatedKeys = merged.updated.map((u) => u.key);
+        const addedKeys = merged.added.map((a) => a.key);
+        const unchangedCount = merged.unchanged.length;
+        const text = `Credentials and connection settings written successfully.
+
+Project path: ${projectCwd}
+File: ${envPath}
+License: ${args.license.slice(0, 4)}-****-****-****
+Server: ${args.serverAddress}:${args.serverPort}
+Database: ${args.dbType}://${args.dbUser}:***@${args.dbHost}:${args.dbPort}/${args.dbName}
+
+Updated keys (${updatedKeys.length}): ${updatedKeys.join(', ') || '(none)'}
+Added keys (${addedKeys.length}): ${addedKeys.join(', ') || '(none)'}
+Unchanged keys (${unchangedCount}): preserved (Live Sync, Redis, Kafka, Logging, etc.)
+
+For the assistant:
+- Confirm to the user that the license and database credentials were saved.
+- Summarise in plain language: which database is configured (type, host, name) and that the license is set; do not echo the literal license key or password.
+- Do not paste the masked summary block verbatim unless the user explicitly asks for the details.
+- Suggest validating the configuration as the next step (license check + database connectivity). Do not mention internal tool names.`;
+        return { content: [{ type: 'text', text }] };
+    });
+}
+//# sourceMappingURL=write-env.js.map

package/dist/tools/setup/write-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-env.js","sourceRoot":"","sources":["../../../src/tools/setup/write-env.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@restforgejs/mcp-server",
+  "version": "1.2.0",
+  "description": "MCP server for RESTForge - enables AI agents to interact with RESTForge via natural language",
+  "type": "module",
+  "bin": {
+    "restforge-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "restforge",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "rest-api",
+    "code-generator"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "RESTForge Development Team",
+    "url": "https://restforge.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/restforge/restforge-mcp.git"
+  },
+  "homepage": "https://github.com/restforge/restforge-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/restforge/restforge-mcp/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "execa": "^9.6.1",
+    "zod": "^4.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  }
+}