diff --git a/src/tools/sql-parameters/index.ts b/src/tools/sql-parameters/index.ts
new file mode 100644
index 00000000..09310bbc
--- /dev/null
+++ b/src/tools/sql-parameters/index.ts
@@ -0,0 +1,13 @@
+import { Database } from '@vicons/tabler';
+import { defineTool } from '../tool';
+
+export const tool = defineTool({
+ name: 'SQL Parameters Generator',
+ path: '/sql-parameters',
+ description: 'Prepare SQL statement from a given parametrized SQL query and parameters',
+ keywords: ['sql', 'select', 'insert', 'parameters'],
+ component: () => import('./sql-parameters.vue'),
+ icon: Database,
+ createdAt: new Date('2025-08-15'),
+ category: 'Development',
+});
diff --git a/src/tools/sql-parameters/sql-parameters.service.test.ts b/src/tools/sql-parameters/sql-parameters.service.test.ts
new file mode 100644
index 00000000..663c4640
--- /dev/null
+++ b/src/tools/sql-parameters/sql-parameters.service.test.ts
@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'vitest';
+import { detectTypeAndEscape, generateSQLFromTemplate } from './sql-parameters.service';
+
+describe('detectTypeAndEscape', () => {
+ it('should return NULL for null-like values', () => {
+ expect(detectTypeAndEscape(null)).toBe('NULL');
+ expect(detectTypeAndEscape(undefined)).toBe('NULL');
+ expect(detectTypeAndEscape('null')).toBe('NULL');
+ });
+
+ it('should detect and return numbers', () => {
+ expect(detectTypeAndEscape('42')).toBe(42);
+ expect(detectTypeAndEscape('3.14')).toBe(3.14);
+ });
+
+ it('should escape and wrap strings in quotes', () => {
+ expect(detectTypeAndEscape('O\'Reilly')).toBe('\'O\'\'Reilly\'');
+ expect(detectTypeAndEscape('hello')).toBe('\'hello\'');
+ });
+});
+
+describe('generateSQLFromTemplate', () => {
+ it('should replace named parameters correctly', () => {
+ const template = 'SELECT * FROM users WHERE name = :name AND age = @age';
+ const params = [
+ { key: 'name', value: 'O\'Reilly' },
+ { key: 'age', value: '42' },
+ ];
+ const { sql, error } = generateSQLFromTemplate(template, params);
+ expect(sql).toBe('SELECT * FROM users WHERE name = \'O\'\'Reilly\' AND age = 42');
+ expect(error).toBeNull();
+ });
+
+ it('should replace positional parameters correctly', () => {
+ const template = 'INSERT INTO products VALUES (?, ?, ?)';
+ const params = [
+ { key: '0', value: 'Book' },
+ { key: '1', value: '19.99' },
+ { key: '2', value: 'null' },
+ ];
+ const { sql, error } = generateSQLFromTemplate(template, params);
+ expect(sql).toBe('INSERT INTO products VALUES (\'Book\', 19.99, NULL)');
+ expect(error).toBeNull();
+ });
+
+ it('should handle escaped question marks', () => {
+ const template = 'SELECT * FROM faq WHERE question LIKE \'\\?\' OR answer = ?';
+ const params = [{ key: '0', value: '42' }];
+ const { sql, error } = generateSQLFromTemplate(template, params);
+ expect(sql).toBe('SELECT * FROM faq WHERE question LIKE \'?\' OR answer = 42');
+ expect(error).toBeNull();
+ });
+
+ it('should return error for missing named parameter', () => {
+ const template = 'SELECT * FROM users WHERE name = :name';
+ const params: Array<{ key: string; value: string }> = [];
+ const { sql, error } = generateSQLFromTemplate(template, params);
+ expect(sql).toBe('');
+ expect(error).toContain('Missing value for named parameter');
+ });
+
+ it('should return error for missing positional parameter', () => {
+ const template = 'SELECT * FROM items WHERE id = ? AND price = ?';
+ const params = [{ key: '0', value: '1' }];
+ const { sql, error } = generateSQLFromTemplate(template, params);
+ expect(sql).toBe('');
+ expect(error).toContain('Missing value for positional parameter');
+ });
+});
diff --git a/src/tools/sql-parameters/sql-parameters.service.ts b/src/tools/sql-parameters/sql-parameters.service.ts
new file mode 100644
index 00000000..d98d61f6
--- /dev/null
+++ b/src/tools/sql-parameters/sql-parameters.service.ts
@@ -0,0 +1,55 @@
+export function detectTypeAndEscape(val: string | null | undefined) {
+ if (val === null || val === undefined || val.toLowerCase?.() === 'null') {
+ return 'NULL';
+ }
+ if (!Number.isNaN(Number(val)) && val.trim() !== '') {
+ return val.includes('.') ? Number.parseFloat(val) : Number.parseInt(val);
+ }
+ return `'${val.replace(/'/g, '\'\'')}'`;
+}
+
+export function generateSQLFromTemplate(template: string, parameters: Array<{ key: string; value: string }>) {
+ const paramMap = new Map();
+ const indexedParams: Array<{ key: string; value: string }> = [];
+ let keyIndex = 0;
+ parameters.forEach(({ key, value }) => {
+ if (key !== '' && !/^\d+$/.test(key)) {
+ paramMap.set(key, detectTypeAndEscape(value));
+ }
+ else {
+ const indexKey = (keyIndex++).toString();
+ indexedParams.push({ key: indexKey, value });
+ }
+ });
+
+ let sql = template;
+ let error = null;
+
+ // Replace named parameters
+ sql = sql.replace(/(:\w+|@\w+)/g, (match) => {
+ const key = match.slice(1);
+ if (!paramMap.has(key)) {
+ error = `Missing value for named parameter "${match}"`;
+ return match;
+ }
+ return paramMap.get(key);
+ });
+
+ // Replace positional parameters
+ let positionalIndex = 0;
+ const positionalParams = indexedParams.filter(p => /^\d+$/.test(p.key));
+
+ sql = sql.replace(/(^|[^\\])\?/g, (_, prefix) => {
+ const param = positionalParams[positionalIndex++];
+ if (!param) {
+ error = `Missing value for positional parameter at index ${positionalIndex - 1}`;
+ return `${prefix}?`;
+ }
+ return `${prefix}${detectTypeAndEscape(param.value)}`;
+ });
+
+ // Unescape escaped question marks
+ sql = sql.replace(/\\\?/g, '?');
+
+ return { sql: error ? '' : sql, error };
+}
diff --git a/src/tools/sql-parameters/sql-parameters.vue b/src/tools/sql-parameters/sql-parameters.vue
new file mode 100644
index 00000000..45bd4557
--- /dev/null
+++ b/src/tools/sql-parameters/sql-parameters.vue
@@ -0,0 +1,61 @@
+
+
+
+
+
+
+
+
+
+
+ For positional parameters, leave Name empty. For named parameters, enter name without '?' or '@' prefix
+
+
+
+
+
+ Generate SQL
+
+
+
+
+
+
+
+
+ {{ errorMessage }}
+
+
+
+