@seatable/mcp-seatable 1.6.3 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -252,6 +252,7 @@ Available metrics:
252
252
  | `mcp_http_requests_total{method, status}` | Counter | HTTP requests by method and status code |
253
253
  | `mcp_rate_limit_exceeded_total{type}` | Counter | Rate limit rejections (global/per_ip/per_token) |
254
254
  | `mcp_auth_validations_total{result}` | Counter | Auth validations (success/failure/cache_hit) |
255
+ | `mcp_sql_failures_total{tool, reason}` | Counter | Failed `query_sql`/`execute_sql` calls (e.g. `subquery`, `join`, `wrong_statement_update`, `seatable_error`) |
255
256
  | `mcp_active_sessions` | Gauge | Currently active HTTP sessions |
256
257
  | `mcp_active_connections` | Gauge | Currently active connections |
257
258
  | `seatable_api_requests_total{operation, status}` | Counter | SeaTable API calls by operation |
@@ -261,6 +262,62 @@ Plus standard Node.js metrics (memory, CPU, event loop) via `prom-client`.
261
262
 
262
263
  The metrics server only starts in HTTP mode (not stdio) and binds to `0.0.0.0` — in Docker, expose the port only within your internal network.
263
264
 
265
+ ### SQL failure log
266
+
267
+ AI models often write MySQL- or PostgreSQL-style SQL that SeaTable does not accept: subqueries, `JOIN`, `UNION`, `CASE WHEN`, `CONCAT()`. To see which patterns fail in practice, every failed `query_sql` or `execute_sql` call writes one log line, without storing any customer data.
268
+
269
+ **What happens on a call.** `runSql()` in `src/mcp/tools/sqlCheck.ts` runs three stages; each failure is logged and counted:
270
+
271
+ | Stage | Example | `reasons` |
272
+ |---|---|---|
273
+ | 1. Constructs SeaTable SQL never supports are rejected before the request | `IN (SELECT …)`, `JOIN`, `UNION`, `WITH`, `OVER (…)`, two statements | `subquery`, `join`, `set_operation`, `cte`, `window_function`, `multiple_statements` |
274
+ | 2. Wrong statement type for the tool | `UPDATE` sent to `query_sql`, `SELECT` sent to `execute_sql`, `DROP` | `wrong_statement_<kind>`, e.g. `wrong_statement_update`, `wrong_statement_other` |
275
+ | 3. SeaTable rejects the statement | unknown function, syntax error, unknown column | `seatable_error`, plus `hints` if MySQL function names were used |
276
+
277
+ In every case the model gets an error message that tells it how to restructure the query, e.g. *"Run the inner SELECT on its own first, then pass its values into the outer query"* or *"use mid(str, pos, len) instead of SUBSTRING"*.
278
+
279
+ **What is logged.** One `WARN` line with the message `SQL statement failed`:
280
+
281
+ ```json
282
+ {"level":"WARN","tool":"query_sql","reasons":["subquery"],
283
+ "sql_shape":"SELECT * FROM `x` WHERE `x` IN (SELECT `x` FROM `x` WHERE `x` = ?)",
284
+ "msg":"SQL statement failed"}
285
+ ```
286
+
287
+ `sql_shape` is the statement with all content removed by `sqlShape()`:
288
+
289
+ - string literals become `?`, numbers become `0`
290
+ - table and column names (quoted or not) become `x`
291
+ - comments are dropped, whitespace is collapsed, the result is cut at 500 characters
292
+ - only SQL keywords (uppercase), function names (lowercase) and punctuation survive
293
+
294
+ The original statement and its `parameters` are never logged; a test in `tests/sqlCheck.spec.ts` asserts that table names and values do not appear in the log. Column names are deliberately dropped as well, since names like "Salary" or "Diagnosis" already say something about the customer.
295
+
296
+ > The general `Tool call failed` line that every tool writes on error is separate and unchanged. For SeaTable errors it contains SeaTable's error message and response body, which may echo column names.
297
+
298
+ **How to analyse it.** The most frequent failing shapes:
299
+
300
+ ```bash
301
+ docker logs <container> 2>&1 | grep '"SQL statement failed"' \
302
+ | jq -r '.sql_shape' | sort | uniq -c | sort -rn | head -30
303
+ ```
304
+
305
+ Failures by reason, and the function hints that were given:
306
+
307
+ ```bash
308
+ docker logs <container> 2>&1 | grep '"SQL statement failed"' | jq -r '.reasons[]' | sort | uniq -c | sort -rn
309
+ docker logs <container> 2>&1 | grep '"SQL statement failed"' | jq -r '.hints[]?' | sort | uniq -c | sort -rn
310
+ ```
311
+
312
+ In Prometheus, `mcp_sql_failures_total{tool, reason}` shows the same reasons over time, e.g. `sum by (reason) (increase(mcp_sql_failures_total[7d]))`. Put that next to `mcp_tool_calls_by_tool_total{tool="query_sql"}` to get a failure rate.
313
+
314
+ **What to do with the results.**
315
+
316
+ - A shape that keeps failing with `seatable_error` and is a fixed grammar limit → add it to `UNSUPPORTED_CONSTRUCTS` so it is rejected before the request, with a restructuring hint.
317
+ - A MySQL function that keeps appearing → add it to `FUNCTION_HINTS`, and to the function mapping in the server instructions (`src/mcp/server.ts`).
318
+ - Many `wrong_statement_*` → the tool descriptions are not clear enough.
319
+ - Function names only produce hints after a failure, never a rejection, so a function SeaTable adds later cannot be blocked by an outdated list.
320
+
264
321
  ## MCP Tools
265
322
 
266
323
  ### Schema Introspection
@@ -276,7 +333,7 @@ The metrics server only starts in HTTP mode (not stdio) and binds to `0.0.0.0`
276
333
  - **`get_row`** — Retrieve specific row by ID
277
334
  - **`find_rows`** — Client-side filtering with DSL
278
335
  - **`search_rows`** — Search via SQL WHERE clauses
279
- - **`query_sql`** — Execute SQL queries with parameterized inputs
336
+ - **`query_sql`** — Read-only SELECT queries with parameterized inputs
280
337
 
281
338
  ### Writing Data
282
339
 
@@ -285,6 +342,7 @@ The metrics server only starts in HTTP mode (not stdio) and binds to `0.0.0.0`
285
342
  - **`update_rows`** — Batch update rows
286
343
  - **`upsert_rows`** — Insert or update rows by key columns
287
344
  - **`delete_rows`** — Remove rows by ID
345
+ - **`execute_sql`** — SQL UPDATE, DELETE or INSERT with parameterized inputs
288
346
 
289
347
  ### Files
290
348
 
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,+CAA+C,CAAA;AAC9E,OAAO,EAEH,KAAK,cAAc,EAGtB,MAAM,oCAAoC,CAAA;AAU3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAsBlE,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAA;AA2BhE,UAAU,cAAc;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,GAAG,CAAA;IAChB,WAAW,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CACtD;AASD,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,SAAS,CAAC,CAAQ;gBAEd,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;QAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE;IAiDvG,kBAAkB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,GAAG,CAAC;QAAC,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAA;KAAE,CAAC;IAM3H,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,gBAAgB;IAoDxB,OAAO,CAAC,kBAAkB;YAKZ,eAAe;YA0Bf,cAAc;CA+E/B;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,qBAwCvD;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB;UArOA,MAAM;iBAAe,MAAM;iBAAe,GAAG;kBAAgB,cAAc,CAAC,aAAa,CAAC;IAuOjI"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,+CAA+C,CAAA;AAC9E,OAAO,EAEH,KAAK,cAAc,EAGtB,MAAM,oCAAoC,CAAA;AAU3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAuBlE,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAA;AA2BhE,UAAU,cAAc;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,GAAG,CAAA;IAChB,WAAW,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;CACtD;AASD,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,SAAS,CAAC,CAAQ;gBAEd,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;QAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE;IAkDvG,kBAAkB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,GAAG,CAAC;QAAC,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAA;KAAE,CAAC;IAM3H,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,gBAAgB;IAqDxB,OAAO,CAAC,kBAAkB;YAKZ,eAAe;YA0Bf,cAAc;CA8F/B;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,qBAwCvD;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB;UArPA,MAAM;iBAAe,MAAM;iBAAe,GAAG;kBAAgB,cAAc,CAAC,aAAa,CAAC;IAuPjI"}
@@ -16,6 +16,7 @@ import { registerCreateSnapshot } from './tools/createSnapshot.js';
16
16
  import { registerDeleteRows } from './tools/deleteRow.js';
17
17
  import { registerDownloadFile } from './tools/downloadFile.js';
18
18
  import { registerEchoArgs } from './tools/echoArgs.js';
19
+ import { registerExecuteSql } from './tools/executeSql.js';
19
20
  import { registerFindRows } from './tools/findRows.js';
20
21
  import { registerGetRow } from './tools/getRow.js';
21
22
  import { registerGetRowActivities } from './tools/getRowActivities.js';
@@ -79,7 +80,8 @@ export class SeaTableMCPServer {
79
80
  'You are connected to a SeaTable base (always spelled with capital S and T).',
80
81
  'Terminology: use "base" (not database), "table" (not sheet), "row" (not record/entry), "column" (not field), "link" (not relation/relationship).',
81
82
  'Views are not supported. All tools return all columns. Filter and sort client-side using find_rows or query_sql.',
82
- 'Prefer query_sql for reading, updating, and deleting data. It supports SELECT, UPDATE...WHERE, and DELETE...WHERE in a single call — much more efficient than fetching row IDs first. SELECT returns max 10,000 rows (vs. list_rows max 1,000 per page).',
83
+ 'Prefer SQL for reading, updating, and deleting data: query_sql for SELECT, execute_sql for UPDATE...WHERE and DELETE...WHERE. One SQL call is much more efficient than fetching row IDs first. SELECT returns max 10,000 rows (vs. list_rows max 1,000 per page).',
84
+ 'SeaTable SQL is a restricted dialect: no subqueries, no WITH, no UNION, no JOIN keyword, no window functions. Keep each query simple and answer multi-step questions with several queries, passing values from one result into the next via ? parameters.',
83
85
  '',
84
86
  'SeaTable SQL does NOT use MySQL/MariaDB function names. You MUST use SeaTable function names:',
85
87
  '- SUBSTR/SUBSTRING → mid(str, pos, len)',
@@ -155,6 +157,7 @@ export class SeaTableMCPServer {
155
157
  registerUnlinkRows(serverAdapter, deps);
156
158
  registerGetSchema(serverAdapter, deps);
157
159
  registerQuerySql(serverAdapter, deps);
160
+ registerExecuteSql(serverAdapter, deps);
158
161
  registerListCollaborators(serverAdapter, deps);
159
162
  registerUploadFile(serverAdapter, deps);
160
163
  registerDownloadFile(serverAdapter, deps);
@@ -216,15 +219,33 @@ export class SeaTableMCPServer {
216
219
  }
217
220
  const start = Date.now();
218
221
  toolCallsByToolTotal.inc({ tool: toolName });
222
+ // Read inside runWithBase(): once the scope has returned, the AsyncLocalStorage
223
+ // store is gone and ContextualClient cannot resolve a base in multi-base mode.
224
+ let baseInfo = {};
225
+ const captureBaseInfo = () => {
226
+ try {
227
+ baseInfo = this.client.getBaseInfo?.() ?? {};
228
+ }
229
+ catch {
230
+ // Base could not be resolved (e.g. missing or unknown "base" argument);
231
+ // the log line then simply omits the base fields.
232
+ }
233
+ };
219
234
  try {
220
235
  // Wrap handler to support thread-safe multi-base routing via AsyncLocalStorage
221
- const runHandler = () => tool.handler(request.params.arguments);
236
+ const runHandler = async () => {
237
+ try {
238
+ return await tool.handler(request.params.arguments);
239
+ }
240
+ finally {
241
+ captureBaseInfo();
242
+ }
243
+ };
222
244
  const result = this.contextualClient
223
245
  ? await this.contextualClient.runWithBase(request.params.arguments?.base, runHandler)
224
246
  : await runHandler();
225
247
  const durationMs = Date.now() - start;
226
248
  const durationSec = durationMs / 1000;
227
- const baseInfo = this.client.getBaseInfo?.() ?? {};
228
249
  logger.info({
229
250
  ...logCtx,
230
251
  ...(baseInfo.dtableUuid && { dtable_uuid: baseInfo.dtableUuid }),
@@ -238,7 +259,6 @@ export class SeaTableMCPServer {
238
259
  catch (error) {
239
260
  const durationMs = Date.now() - start;
240
261
  const durationSec = durationMs / 1000;
241
- const baseInfo = this.client.getBaseInfo?.() ?? {};
242
262
  const errorCode = error?.code;
243
263
  const isClientError = typeof errorCode === 'string' && CLIENT_ERROR_CODES.has(errorCode);
244
264
  const errorCtx = {
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { ToolRegistrar } from './types.js';
2
+ export declare const registerExecuteSql: ToolRegistrar;
3
+ //# sourceMappingURL=executeSql.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executeSql.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/executeSql.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ1C,eAAO,MAAM,kBAAkB,EAAE,aA+BhC,CAAA"}
@@ -0,0 +1,36 @@
1
+ import { z } from 'zod';
2
+ import { runSql, SQL_SYNTAX_RULES } from './sqlCheck.js';
3
+ import { cleanSqlMetadata } from './utils.js';
4
+ const InputSchema = z.object({
5
+ sql: z.string().describe('UPDATE, DELETE or INSERT statement').refine(sql => sql.trim().length > 0, 'SQL statement cannot be empty'),
6
+ parameters: z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).optional().describe('Values for ? placeholders in the SQL statement'),
7
+ });
8
+ export const registerExecuteSql = (server, { client, getInputSchema }) => {
9
+ server.registerTool('execute_sql', {
10
+ title: 'Execute SQL',
11
+ description: `Run an UPDATE, DELETE or INSERT statement against SeaTable. Changes many rows in one call, e.g. UPDATE \`T\` SET \`Status\` = ? WHERE \`Done\` = true. Use ? placeholders for parameters. For reading data, use query_sql.
12
+
13
+ ${SQL_SYNTAX_RULES}
14
+
15
+ UPDATE limitations:
16
+ - SET only accepts literal values (strings, numbers, booleans). No functions (date(), now(), upper()…) and no expressions (Amount + 10) allowed.
17
+ - Columns not updatable via SQL: image, file, formula, link, link-formula, geolocation, auto-number, digital-sign, button. Use update_rows or link_rows for those.
18
+
19
+ INSERT only works with Big Data storage enabled (Enterprise). For non-archived tables, use append_rows instead.`,
20
+ inputSchema: getInputSchema(InputSchema),
21
+ annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
22
+ }, async (args) => {
23
+ const { sql, parameters } = InputSchema.parse(args);
24
+ const result = await runSql('execute_sql', sql, () => client.querySql(sql, parameters));
25
+ return {
26
+ content: [{
27
+ type: 'text',
28
+ text: JSON.stringify({
29
+ metadata: cleanSqlMetadata(result.metadata),
30
+ results: result.results,
31
+ }),
32
+ }],
33
+ };
34
+ });
35
+ };
36
+ //# sourceMappingURL=executeSql.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executeSql.js","sourceRoot":"","sources":["../../../src/mcp/tools/executeSql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,+BAA+B,CAAC;IACpI,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACtJ,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAkB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE;IACpF,MAAM,CAAC,YAAY,CACf,aAAa,EACb;QACI,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE;;EAEvB,gBAAgB;;;;;;gHAM8F;QACpG,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC;QACxC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KAC3G,EACD,KAAK,EAAE,IAAa,EAAE,EAAE;QACpB,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;QACvF,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACjB,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC;wBAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;qBAC1B,CAAC;iBACL,CAAC;SACL,CAAA;IACL,CAAC,CACJ,CAAA;AACL,CAAC,CAAA"}
@@ -1 +1 @@
1
- {"version":3,"file":"querySql.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/querySql.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ1C,eAAO,MAAM,gBAAgB,EAAE,aA0C9B,CAAA"}
1
+ {"version":3,"file":"querySql.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/querySql.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ1C,eAAO,MAAM,gBAAgB,EAAE,aAgC9B,CAAA"}
@@ -1,37 +1,28 @@
1
1
  import { z } from 'zod';
2
+ import { runSql, SQL_SYNTAX_RULES } from './sqlCheck.js';
2
3
  import { cleanSqlMetadata } from './utils.js';
3
4
  const InputSchema = z.object({
4
- sql: z.string().describe('SQL query (SELECT, INSERT, UPDATE, DELETE)').refine(sql => sql.trim().length > 0, 'SQL query cannot be empty'),
5
+ sql: z.string().describe('SELECT statement').refine(sql => sql.trim().length > 0, 'SQL query cannot be empty'),
5
6
  parameters: z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).optional().describe('Values for ? placeholders in the SQL query'),
6
7
  });
7
8
  export const registerQuerySql = (server, { client, getInputSchema }) => {
8
9
  server.registerTool('query_sql', {
9
10
  title: 'Query SQL',
10
- description: `Execute SQL queries against SeaTable (SELECT, UPDATE, DELETE, INSERT). Use ? placeholders for parameters.
11
+ description: `Run a read-only SELECT query against SeaTable. Use ? placeholders for parameters. To change data with SQL, use execute_sql.
11
12
 
12
- Syntax rules:
13
- - Quote table/column names with backticks: \`Table Name\`, \`Column Name\` (not double quotes). Required for names with spaces, hyphens, or names matching function names.
14
- - SELECT returns max 100 rows by default. Use LIMIT to get more (up to 10,000).
15
- - Aliases (AS) can be used in GROUP BY, HAVING, ORDER BY — but NOT in WHERE.
16
- - ORDER BY columns must appear in the SELECT field list.
17
- - No JOIN keyword. Use implicit joins: FROM \`T1\`, \`T2\` WHERE \`T1\`.\`col\` = \`T2\`.\`col\`. Only inner joins are supported.
18
- - No subqueries, no UNION/UNION ALL.
19
- - Empty strings are treated as NULL. Use IS NULL / IS NOT NULL instead of = "".
20
- - Use ILIKE for case-insensitive matching (LIKE is case-sensitive).
21
- - For multi-select/collaborator columns use: HAS ANY OF, HAS ALL OF, HAS NONE OF, IS EXACTLY (values in parentheses like IN).
22
-
23
- UPDATE limitations:
24
- - SET only accepts literal values (strings, numbers, booleans). No functions (date(), now(), upper()…) and no expressions (Amount + 10) allowed.
25
- - Columns not updatable via SQL: image, file, formula, link, link-formula, geolocation, auto-number, digital-sign, button.
13
+ ${SQL_SYNTAX_RULES}
26
14
 
27
- INSERT only works with Big Data storage enabled (Enterprise). For non-archived tables, use append_rows instead.
15
+ SELECT rules:
16
+ - Returns max 100 rows by default. Use LIMIT to get more (up to 10,000).
17
+ - Aliases (AS) can be used in GROUP BY, HAVING, ORDER BY — but NOT in WHERE.
18
+ - Joins: FROM \`T1\`, \`T2\` WHERE \`T1\`.\`col\` = \`T2\`.\`col\` (inner joins only).
28
19
 
29
- If a query fails, do not retry with similar syntax. Switch to an alternative tool (e.g. update_rows, find_rows) instead.`,
20
+ If a query is rejected, find_rows offers client-side filtering as an alternative.`,
30
21
  inputSchema: getInputSchema(InputSchema),
31
- annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
22
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
32
23
  }, async (args) => {
33
24
  const { sql, parameters } = InputSchema.parse(args);
34
- const result = await client.querySql(sql, parameters);
25
+ const result = await runSql('query_sql', sql, () => client.querySql(sql, parameters));
35
26
  return {
36
27
  content: [{
37
28
  type: 'text',
@@ -1 +1 @@
1
- {"version":3,"file":"querySql.js","sourceRoot":"","sources":["../../../src/mcp/tools/querySql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,2BAA2B,CAAC;IACxI,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAClJ,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAkB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE;IAClF,MAAM,CAAC,YAAY,CACf,WAAW,EACX;QACI,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;yHAmBgG;QAC7G,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC;QACxC,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KAC3G,EACD,KAAK,EAAE,IAAa,EAAE,EAAE;QACpB,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QACrD,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACjB,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC;wBAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;qBAC1B,CAAC;iBACL,CAAC;SACL,CAAA;IACL,CAAC,CACJ,CAAA;AACL,CAAC,CAAA"}
1
+ {"version":3,"file":"querySql.js","sourceRoot":"","sources":["../../../src/mcp/tools/querySql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,2BAA2B,CAAC;IAC9G,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAClJ,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAkB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE;IAClF,MAAM,CAAC,YAAY,CACf,WAAW,EACX;QACI,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE;;EAEvB,gBAAgB;;;;;;;kFAOgE;QACtE,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC;QACxC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1G,EACD,KAAK,EAAE,IAAa,EAAE,EAAE;QACpB,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;QACrF,OAAO;YACH,OAAO,EAAE,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACjB,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC;wBAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;qBAC1B,CAAC;iBACL,CAAC;SACL,CAAA;IACL,CAAC,CACJ,CAAA;AACL,CAAC,CAAA"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Static checks for SeaTable SQL. SeaTable implements a restricted SQL dialect;
3
+ * models tend to write MySQL/PostgreSQL and then burn several round trips on
4
+ * errors. Constructs SeaTable never accepts are rejected before the request,
5
+ * and function names known to fail get a hint appended to SeaTable's error.
6
+ */
7
+ export type StatementKind = 'select' | 'update' | 'delete' | 'insert' | 'other';
8
+ /**
9
+ * Replace string literals, quoted identifiers and comments with neutral
10
+ * placeholders so keyword checks don't fire on `Join Date` or 'union station'.
11
+ */
12
+ export declare function stripLiterals(sql: string): string;
13
+ export declare function statementKind(sql: string): StatementKind;
14
+ /**
15
+ * Throw ERR_VALIDATION if the statement uses a construct SeaTable SQL never
16
+ * accepts. These are grammar limits, so rejecting them cannot block a query
17
+ * that would have worked.
18
+ */
19
+ export declare function assertSupportedSql(sql: string): void;
20
+ /**
21
+ * Hints for MySQL function names in a statement that SeaTable rejected. Only
22
+ * used after a failure: some names may be valid in a future SeaTable release,
23
+ * so they never block a request on their own.
24
+ */
25
+ export declare function functionHints(sql: string): string[];
26
+ /**
27
+ * The structure of a statement with all customer content removed, for logs.
28
+ * Literals become ? or 0, table and column names become x, so only keywords,
29
+ * function names and punctuation survive:
30
+ * SELECT `Name` FROM `Kunden` WHERE mid(`PLZ`, 1, 2) = '55'
31
+ * → SELECT `x` FROM `x` WHERE mid(`x`, 0, 0) = ?
32
+ */
33
+ export declare function sqlShape(sql: string): string;
34
+ type SqlTool = 'query_sql' | 'execute_sql';
35
+ /**
36
+ * Check a statement for the given tool and run it. Every failure is counted
37
+ * and logged as a content-free shape (see sqlShape), so the patterns models
38
+ * get wrong can be analysed without storing customer data.
39
+ */
40
+ export declare function runSql<T>(tool: SqlTool, sql: string, run: () => Promise<T>): Promise<T>;
41
+ export declare const SQL_SYNTAX_RULES = "Syntax rules:\n- Quote table/column names with backticks: `Table Name`, `Column Name` (not double quotes). Required for names with spaces, hyphens, or names matching function names.\n- Empty strings are treated as NULL. Use IS NULL / IS NOT NULL instead of = \"\".\n- Use ILIKE for case-insensitive matching (LIKE is case-sensitive).\n- For multi-select/collaborator columns use: HAS ANY OF, HAS ALL OF, HAS NONE OF, IS EXACTLY (values in parentheses like IN).\n- Not supported: subqueries, WITH (CTE), UNION/INTERSECT/EXCEPT, the JOIN keyword, window functions (OVER), multiple statements. Such queries are rejected before they run. Split them into several simple queries instead.\n- SeaTable function names differ from MySQL (e.g. mid, concatenate, len, dateAdd, if/ifs); see the server instructions.";
42
+ export {};
43
+ //# sourceMappingURL=sqlCheck.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sqlCheck.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/sqlCheck.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE/E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoCjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIxD;AAmCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAUpD;AA8BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnD;AAYD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAY5C;AAED,KAAK,OAAO,GAAG,WAAW,GAAG,aAAa,CAAA;AAoB1C;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAyB7F;AAED,eAAO,MAAM,gBAAgB,uyBAM2F,CAAA"}
@@ -0,0 +1,220 @@
1
+ import { makeError } from '../../errors.js';
2
+ import { logger } from '../../logger.js';
3
+ import { sqlFailuresTotal } from '../../metrics/index.js';
4
+ /**
5
+ * Replace string literals, quoted identifiers and comments with neutral
6
+ * placeholders so keyword checks don't fire on `Join Date` or 'union station'.
7
+ */
8
+ export function stripLiterals(sql) {
9
+ let out = '';
10
+ let i = 0;
11
+ while (i < sql.length) {
12
+ const ch = sql[i];
13
+ const next = sql[i + 1];
14
+ if (ch === '-' && next === '-') {
15
+ const end = sql.indexOf('\n', i);
16
+ i = end === -1 ? sql.length : end;
17
+ out += ' ';
18
+ continue;
19
+ }
20
+ if (ch === '/' && next === '*') {
21
+ const end = sql.indexOf('*/', i + 2);
22
+ i = end === -1 ? sql.length : end + 2;
23
+ out += ' ';
24
+ continue;
25
+ }
26
+ if (ch === "'" || ch === '"' || ch === '`') {
27
+ let j = i + 1;
28
+ while (j < sql.length) {
29
+ if (sql[j] === '\\' && ch !== '`') {
30
+ j += 2;
31
+ continue;
32
+ }
33
+ if (sql[j] === ch) {
34
+ if (sql[j + 1] === ch) {
35
+ j += 2;
36
+ continue;
37
+ }
38
+ break;
39
+ }
40
+ j++;
41
+ }
42
+ out += ch === '`' ? '`x`' : "''";
43
+ i = j + 1;
44
+ continue;
45
+ }
46
+ out += ch;
47
+ i++;
48
+ }
49
+ return out;
50
+ }
51
+ export function statementKind(sql) {
52
+ const match = /^[\s(]*([a-z]+)/i.exec(stripLiterals(sql));
53
+ const word = match?.[1].toLowerCase();
54
+ return word === 'select' || word === 'update' || word === 'delete' || word === 'insert' ? word : 'other';
55
+ }
56
+ const UNSUPPORTED_CONSTRUCTS = [
57
+ {
58
+ reason: 'cte',
59
+ pattern: /^\s*with\b/i,
60
+ message: 'Common table expressions (WITH ... AS) are not supported. Run the inner query on its own first and use its results in a second query.',
61
+ },
62
+ {
63
+ reason: 'subquery',
64
+ pattern: /\(\s*select\b/i,
65
+ message: 'Subqueries are not supported. Run the inner SELECT on its own first, then pass its values into the outer query, e.g. WHERE `Col` IN (?, ?, ?) with parameters.',
66
+ },
67
+ {
68
+ reason: 'set_operation',
69
+ pattern: /\b(union|intersect|except)\b/i,
70
+ message: 'UNION, INTERSECT and EXCEPT are not supported. Run one query per part and combine the results yourself.',
71
+ },
72
+ {
73
+ reason: 'join',
74
+ pattern: /\bjoin\b/i,
75
+ message: 'The JOIN keyword is not supported. Use an implicit inner join: FROM `T1`, `T2` WHERE `T1`.`col` = `T2`.`col`. Outer joins are not available; query the tables separately instead.',
76
+ },
77
+ {
78
+ reason: 'window_function',
79
+ pattern: /\bover\s*\(/i,
80
+ message: 'Window functions (OVER ...) are not supported. Use GROUP BY for aggregates, or compute rankings from the returned rows.',
81
+ },
82
+ {
83
+ reason: 'multiple_statements',
84
+ pattern: /;\s*\S/,
85
+ message: 'Only one statement per call is supported. Send each statement in its own call.',
86
+ },
87
+ ];
88
+ /**
89
+ * Throw ERR_VALIDATION if the statement uses a construct SeaTable SQL never
90
+ * accepts. These are grammar limits, so rejecting them cannot block a query
91
+ * that would have worked.
92
+ */
93
+ export function assertSupportedSql(sql) {
94
+ const stripped = stripLiterals(sql);
95
+ const problems = UNSUPPORTED_CONSTRUCTS.filter(c => c.pattern.test(stripped));
96
+ if (problems.length) {
97
+ throw makeError('ERR_VALIDATION', `SeaTable SQL does not support this query. ${problems.map(c => c.message).join(' ')}`, { reasons: problems.map(c => c.reason) });
98
+ }
99
+ }
100
+ const FUNCTION_HINTS = [
101
+ { pattern: /\b(substr|substring)\s*\(/i, hint: 'use mid(str, pos, len) instead of SUBSTR/SUBSTRING' },
102
+ { pattern: /\b(concat|concat_ws)\s*\(/i, hint: 'use concatenate(str1, str2, ...) instead of CONCAT' },
103
+ { pattern: /\b(length|char_length)\s*\(/i, hint: 'use len(str) instead of LENGTH' },
104
+ { pattern: /\brepeat\s*\(/i, hint: 'use rept(str, n) instead of REPEAT' },
105
+ { pattern: /\b(locate|instr)\s*\(/i, hint: 'use find(substr, str) or search(substr, str) instead of LOCATE/INSTR' },
106
+ { pattern: /\bucase\s*\(/i, hint: 'use upper(str) instead of UCASE' },
107
+ { pattern: /\blcase\s*\(/i, hint: 'use lower(str) instead of LCASE' },
108
+ { pattern: /\bformat\s*\(/i, hint: 'use text(num, format) instead of FORMAT' },
109
+ { pattern: /\b(curdate\s*\(|current_date\b)/i, hint: 'use today() instead of CURDATE/CURRENT_DATE' },
110
+ { pattern: /\b(date_add|date_sub)\s*\(/i, hint: 'use dateAdd(date, n, "unit") instead of DATE_ADD/DATE_SUB' },
111
+ { pattern: /\b(datediff|timestampdiff)\s*\(/i, hint: 'use dateDif(d1, d2, unit) instead of DATEDIFF/TIMESTAMPDIFF' },
112
+ { pattern: /\bextract\s*\(/i, hint: 'use year(date), month(date), day(date) instead of EXTRACT' },
113
+ { pattern: /\bdayofweek\s*\(/i, hint: 'use weekday(date, weekStart) instead of DAYOFWEEK' },
114
+ { pattern: /\bweek\s*\(/i, hint: 'use weeknum(date, return_type) instead of WEEK' },
115
+ { pattern: /\blast_day\s*\(/i, hint: 'use eomonth(date, 0) instead of LAST_DAY' },
116
+ { pattern: /\bceil\s*\(/i, hint: 'use ceiling(n) instead of CEIL' },
117
+ { pattern: /\bpow\s*\(/i, hint: 'use power(a, b) instead of POW' },
118
+ { pattern: /\blog10\s*\(/i, hint: 'use lg(n) instead of LOG10' },
119
+ { pattern: /\blog2\s*\(/i, hint: 'use log(n, 2) instead of LOG2' },
120
+ { pattern: /\btruncate\s*\(/i, hint: 'use rounddown(n, d) instead of TRUNCATE' },
121
+ { pattern: /\bcase\s+when\b/i, hint: 'use if(cond, a, b) or ifs(cond1, val1, cond2, val2, ...) instead of CASE WHEN' },
122
+ {
123
+ pattern: /\b(cast|convert|greatest|least|coalesce|ifnull|nullif|rand|group_concat|lpad|rpad|reverse|dayname|monthname|str_to_date)\s*\(/i,
124
+ hint: 'CAST, CONVERT, GREATEST, LEAST, COALESCE, IFNULL, NULLIF, RAND, GROUP_CONCAT, LPAD, RPAD, REVERSE, DAYNAME, MONTHNAME and STR_TO_DATE do not exist in SeaTable SQL',
125
+ },
126
+ ];
127
+ /**
128
+ * Hints for MySQL function names in a statement that SeaTable rejected. Only
129
+ * used after a failure: some names may be valid in a future SeaTable release,
130
+ * so they never block a request on their own.
131
+ */
132
+ export function functionHints(sql) {
133
+ const stripped = stripLiterals(sql);
134
+ return FUNCTION_HINTS.filter(h => h.pattern.test(stripped)).map(h => h.hint);
135
+ }
136
+ const SQL_KEYWORDS = new Set([
137
+ 'select', 'distinct', 'from', 'where', 'and', 'or', 'not', 'in', 'is', 'null', 'like', 'ilike', 'between',
138
+ 'group', 'by', 'having', 'order', 'asc', 'desc', 'limit', 'offset', 'as', 'update', 'set', 'delete', 'insert',
139
+ 'into', 'values', 'join', 'left', 'right', 'inner', 'outer', 'full', 'cross', 'on', 'union', 'all', 'intersect',
140
+ 'except', 'with', 'over', 'partition', 'case', 'when', 'then', 'else', 'end', 'true', 'false', 'has', 'any',
141
+ 'of', 'none', 'exactly',
142
+ ]);
143
+ const MAX_SHAPE_LENGTH = 500;
144
+ /**
145
+ * The structure of a statement with all customer content removed, for logs.
146
+ * Literals become ? or 0, table and column names become x, so only keywords,
147
+ * function names and punctuation survive:
148
+ * SELECT `Name` FROM `Kunden` WHERE mid(`PLZ`, 1, 2) = '55'
149
+ * → SELECT `x` FROM `x` WHERE mid(`x`, 0, 0) = ?
150
+ */
151
+ export function sqlShape(sql) {
152
+ const shape = stripLiterals(sql)
153
+ .replace(/''/g, '?')
154
+ .replace(/\b\d+(\.\d+)?\b/g, '0')
155
+ .replace(/\b[a-z_][a-z0-9_]*\b(?=(\s*\()?)/gi, (word, call) => {
156
+ const lower = word.toLowerCase();
157
+ if (SQL_KEYWORDS.has(lower))
158
+ return word.toUpperCase();
159
+ return call ? lower : 'x';
160
+ })
161
+ .replace(/\s+/g, ' ')
162
+ .trim();
163
+ return shape.length > MAX_SHAPE_LENGTH ? `${shape.slice(0, MAX_SHAPE_LENGTH)}…` : shape;
164
+ }
165
+ const ALLOWED_KINDS = {
166
+ query_sql: {
167
+ kinds: ['select'],
168
+ reject: () => 'query_sql only runs SELECT statements. Use execute_sql for UPDATE, DELETE or INSERT.',
169
+ },
170
+ execute_sql: {
171
+ kinds: ['update', 'delete', 'insert'],
172
+ reject: kind => kind === 'select'
173
+ ? 'execute_sql does not run SELECT statements. Use query_sql to read data.'
174
+ : 'execute_sql only runs UPDATE, DELETE or INSERT statements.',
175
+ },
176
+ };
177
+ function recordFailure(tool, sql, reasons, hints = []) {
178
+ for (const reason of reasons)
179
+ sqlFailuresTotal.inc({ tool, reason });
180
+ logger.warn({ tool, reasons, sql_shape: sqlShape(sql), ...(hints.length && { hints }) }, 'SQL statement failed');
181
+ }
182
+ /**
183
+ * Check a statement for the given tool and run it. Every failure is counted
184
+ * and logged as a content-free shape (see sqlShape), so the patterns models
185
+ * get wrong can be analysed without storing customer data.
186
+ */
187
+ export async function runSql(tool, sql, run) {
188
+ try {
189
+ assertSupportedSql(sql);
190
+ }
191
+ catch (err) {
192
+ recordFailure(tool, sql, err.meta?.reasons ?? ['unsupported']);
193
+ throw err;
194
+ }
195
+ const kind = statementKind(sql);
196
+ const { kinds, reject } = ALLOWED_KINDS[tool];
197
+ if (!kinds.includes(kind)) {
198
+ recordFailure(tool, sql, [`wrong_statement_${kind}`]);
199
+ throw makeError('ERR_VALIDATION', reject(kind));
200
+ }
201
+ try {
202
+ return await run();
203
+ }
204
+ catch (err) {
205
+ const hints = functionHints(sql);
206
+ recordFailure(tool, sql, ['seatable_error'], hints);
207
+ if (hints.length && err instanceof Error) {
208
+ err.message = `${err.message} Hint: ${hints.join('; ')}.`;
209
+ }
210
+ throw err;
211
+ }
212
+ }
213
+ export const SQL_SYNTAX_RULES = `Syntax rules:
214
+ - Quote table/column names with backticks: \`Table Name\`, \`Column Name\` (not double quotes). Required for names with spaces, hyphens, or names matching function names.
215
+ - Empty strings are treated as NULL. Use IS NULL / IS NOT NULL instead of = "".
216
+ - Use ILIKE for case-insensitive matching (LIKE is case-sensitive).
217
+ - For multi-select/collaborator columns use: HAS ANY OF, HAS ALL OF, HAS NONE OF, IS EXACTLY (values in parentheses like IN).
218
+ - Not supported: subqueries, WITH (CTE), UNION/INTERSECT/EXCEPT, the JOIN keyword, window functions (OVER), multiple statements. Such queries are rejected before they run. Split them into several simple queries instead.
219
+ - SeaTable function names differ from MySQL (e.g. mid, concatenate, len, dateAdd, if/ifs); see the server instructions.`;
220
+ //# sourceMappingURL=sqlCheck.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sqlCheck.js","sourceRoot":"","sources":["../../../src/mcp/tools/sqlCheck.ts"],"names":[],"mappings":"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"}
@@ -2,6 +2,7 @@ import { Counter, Gauge, Histogram, Registry } from 'prom-client';
2
2
  export declare const register: Registry<"text/plain; version=0.0.4; charset=utf-8">;
3
3
  export declare const toolCallsTotal: Counter<"status" | "tool">;
4
4
  export declare const toolCallsByToolTotal: Counter<"tool">;
5
+ export declare const sqlFailuresTotal: Counter<"tool" | "reason">;
5
6
  export declare const httpRequestsTotal: Counter<"status" | "method">;
6
7
  export declare const rateLimitExceededTotal: Counter<"type">;
7
8
  export declare const authValidationsTotal: Counter<"result">;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAExF,eAAO,MAAM,QAAQ,sDAAiB,CAAA;AAOtC,eAAO,MAAM,cAAc,4BAKzB,CAAA;AAEF,eAAO,MAAM,oBAAoB,iBAK/B,CAAA;AAEF,eAAO,MAAM,iBAAiB,8BAK5B,CAAA;AAEF,eAAO,MAAM,sBAAsB,iBAKjC,CAAA;AAEF,eAAO,MAAM,oBAAoB,mBAK/B,CAAA;AAEF,eAAO,MAAM,wBAAwB,iCAKnC,CAAA;AAIF,eAAO,MAAM,mBAAmB,mBAM9B,CAAA;AAEF,eAAO,MAAM,0BAA0B,wBAMrC,CAAA;AAIF,eAAO,MAAM,cAAc,eAIzB,CAAA;AAEF,eAAO,MAAM,iBAAiB,eAI5B,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAExF,eAAO,MAAM,QAAQ,sDAAiB,CAAA;AAOtC,eAAO,MAAM,cAAc,4BAKzB,CAAA;AAEF,eAAO,MAAM,oBAAoB,iBAK/B,CAAA;AAEF,eAAO,MAAM,gBAAgB,4BAK3B,CAAA;AAEF,eAAO,MAAM,iBAAiB,8BAK5B,CAAA;AAEF,eAAO,MAAM,sBAAsB,iBAKjC,CAAA;AAEF,eAAO,MAAM,oBAAoB,mBAK/B,CAAA;AAEF,eAAO,MAAM,wBAAwB,iCAKnC,CAAA;AAIF,eAAO,MAAM,mBAAmB,mBAM9B,CAAA;AAEF,eAAO,MAAM,0BAA0B,wBAMrC,CAAA;AAIF,eAAO,MAAM,cAAc,eAIzB,CAAA;AAEF,eAAO,MAAM,iBAAiB,eAI5B,CAAA"}
@@ -15,6 +15,12 @@ export const toolCallsByToolTotal = new Counter({
15
15
  labelNames: ['tool'],
16
16
  registers: [register],
17
17
  });
18
+ export const sqlFailuresTotal = new Counter({
19
+ name: 'mcp_sql_failures_total',
20
+ help: 'Failed query_sql/execute_sql calls by reason (unsupported construct, wrong statement type, SeaTable error)',
21
+ labelNames: ['tool', 'reason'],
22
+ registers: [register],
23
+ });
18
24
  export const httpRequestsTotal = new Counter({
19
25
  name: 'mcp_http_requests_total',
20
26
  help: 'Total number of HTTP requests',
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"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"}
@@ -15,6 +15,14 @@ export declare class ContextualClient implements ClientLike {
15
15
  * will route to the specified base.
16
16
  */
17
17
  runWithBase<T>(name: string | undefined, fn: () => T): T;
18
+ /**
19
+ * Resolving outside a runWithBase() scope is always a programming error, and
20
+ * it used to hide well: with a single base it quietly succeeded via the
21
+ * registry default, and only with two or more did it surface — as "Specify
22
+ * base parameter", which blames the caller for omitting an argument they
23
+ * did supply. It cost five months to find that way once, so it is named
24
+ * here and fails the same way whatever the base count.
25
+ */
18
26
  private get client();
19
27
  getBaseInfo(): {
20
28
  dtableUuid?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"contextualClient.d.ts","sourceRoot":"","sources":["../../src/seatable/contextualClient.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"contextualClient.d.ts","sourceRoot":"","sources":["../../src/seatable/contextualClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AASzD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,QAAQ,EAAE,cAAc;IAIpC;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIxD;;;;;;;OAOG;IACH,OAAO,KAAK,MAAM,GASjB;IAGD,WAAW;;;;IAGX,UAAU;;;;IAGV,WAAW;IACX,kBAAkB;IAGlB,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;IACpE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IACnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;;;IAC1F,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;IACtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;;;IAC1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;IAGxD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE;;;;IAGxC,iBAAiB;;;;IAGjB,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;IAC7G,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;IAG7G,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE;IAG9H,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;;;;IAG7C,cAAc;;;;;;;;;IAGd,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;IAGxH,YAAY,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;CACzF"}
@@ -1,4 +1,9 @@
1
1
  import { AsyncLocalStorage } from 'node:async_hooks';
2
+ /**
3
+ * The store is an object rather than the bare name so that "no scope at all"
4
+ * (getStore() === undefined) stays distinguishable from "in a scope, no base
5
+ * named" ({ base: undefined }). Those two need very different errors.
6
+ */
2
7
  const baseContext = new AsyncLocalStorage();
3
8
  /**
4
9
  * A ClientLike proxy that delegates to a specific base client
@@ -17,10 +22,23 @@ export class ContextualClient {
17
22
  * will route to the specified base.
18
23
  */
19
24
  runWithBase(name, fn) {
20
- return baseContext.run(name, fn);
25
+ return baseContext.run({ base: name }, fn);
21
26
  }
27
+ /**
28
+ * Resolving outside a runWithBase() scope is always a programming error, and
29
+ * it used to hide well: with a single base it quietly succeeded via the
30
+ * registry default, and only with two or more did it surface — as "Specify
31
+ * base parameter", which blames the caller for omitting an argument they
32
+ * did supply. It cost five months to find that way once, so it is named
33
+ * here and fails the same way whatever the base count.
34
+ */
22
35
  get client() {
23
- return this.registry.resolve(baseContext.getStore());
36
+ const store = baseContext.getStore();
37
+ if (!store) {
38
+ throw new Error('ContextualClient was used outside runWithBase(). The base context only exists for the '
39
+ + 'duration of that scope — read what you need inside it rather than after it returns.');
40
+ }
41
+ return this.registry.resolve(store.base);
24
42
  }
25
43
  // Base info
26
44
  getBaseInfo() { return this.client.getBaseInfo?.() ?? {}; }
@@ -1 +1 @@
1
- {"version":3,"file":"contextualClient.js","sourceRoot":"","sources":["../../src/seatable/contextualClient.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"contextualClient.js","sourceRoot":"","sources":["../../src/seatable/contextualClient.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seatable/mcp-seatable",
3
- "version": "1.6.3",
3
+ "version": "1.7.0",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "mcpName": "io.github.seatable/seatable",