@seatable/mcp-seatable 1.3.3 → 1.3.5

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
@@ -256,7 +256,7 @@ The metrics server only starts in HTTP mode (not stdio) and binds to `0.0.0.0`
256
256
  ### Utilities
257
257
 
258
258
  - **`get_row_activities`** — Get change history of a row (who changed what, when, old/new values)
259
- - **`create_snapshot`** — Create a snapshot of the current base (requires changes since last snapshot, 10 min cooldown)
259
+ - **`create_snapshot`** — Create a snapshot of the current base (10 min cooldown)
260
260
  - **`add_select_options`** — Add new options to single-select or multi-select columns
261
261
  - **`ping_seatable`** — Health check with latency monitoring
262
262
 
@@ -325,7 +325,7 @@ In-memory tables and rows for demos and tests without a live SeaTable instance.
325
325
 
326
326
  ### Prerequisites
327
327
 
328
- - Node.js >= 18
328
+ - Node.js >= 20
329
329
 
330
330
  ### Setup
331
331
 
@@ -1 +1 @@
1
- {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAKlC,QAAA,IAAI,MAAM,EAAE,MAAM,CAAA;AAmClB,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,0BAEvE"}
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAKlC,QAAA,IAAI,MAAM,EAAE,MAAM,CAAA;AAsClB,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,0BAEvE"}
package/dist/logger.js CHANGED
@@ -16,7 +16,7 @@ if (typeof process !== 'undefined' && process.versions?.node && !('WebSocketPair
16
16
  return { level: label.toUpperCase() };
17
17
  },
18
18
  },
19
- });
19
+ }, process.stderr);
20
20
  }
21
21
  else {
22
22
  const createFallbackLogger = () => {
@@ -1 +1 @@
1
- {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI3C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAA;AAE7D,IAAI,MAAc,CAAA;AAElB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,eAAe,IAAI,UAAU,CAAC,EAAE,CAAC;IAC/F,+EAA+E;IAC/E,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC,MAAM,IAAI,GAAQ,UAAU,CAAC,OAAO,CAAA;IACpC,MAAM,GAAG,IAAI,CAAC;QACV,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QACvD,MAAM,EAAE,CAAC,2BAA2B,EAAE,8BAA8B,CAAC;QACrE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO;QAC1C,UAAU,EAAE;YACR,KAAK,CAAC,KAAa;gBACf,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAA;YACzC,CAAC;SACJ;KACJ,CAAW,CAAA;AAChB,CAAC;KAAM,CAAC;IACJ,MAAM,oBAAoB,GAAG,GAAG,EAAE;QAC9B,MAAM,IAAI,GAAQ;YACd,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAClD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;SACnB,CAAA;QACD,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA;QACvB,OAAO,IAAc,CAAA;IACzB,CAAC,CAAA;IACD,MAAM,GAAG,oBAAoB,EAAE,CAAA;AACnC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,MAAM,UAAU,WAAW,CAAoC,MAAS;IACpE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI3C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAA;AAE7D,IAAI,MAAc,CAAA;AAElB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,eAAe,IAAI,UAAU,CAAC,EAAE,CAAC;IAC/F,+EAA+E;IAC/E,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC,MAAM,IAAI,GAAQ,UAAU,CAAC,OAAO,CAAA;IACpC,MAAM,GAAG,IAAI,CACT;QACI,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QACvD,MAAM,EAAE,CAAC,2BAA2B,EAAE,8BAA8B,CAAC;QACrE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO;QAC1C,UAAU,EAAE;YACR,KAAK,CAAC,KAAa;gBACf,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAA;YACzC,CAAC;SACJ;KACJ,EACD,OAAO,CAAC,MAAM,CACP,CAAA;AACf,CAAC;KAAM,CAAC;IACJ,MAAM,oBAAoB,GAAG,GAAG,EAAE;QAC9B,MAAM,IAAI,GAAQ;YACd,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAClD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACrD,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;SACnB,CAAA;QACD,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA;QACvB,OAAO,IAAc,CAAA;IACzB,CAAC,CAAA;IACD,MAAM,GAAG,oBAAoB,EAAE,CAAA;AACnC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAA;AAEjB,MAAM,UAAU,WAAW,CAAoC,MAAS;IACpE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}
@@ -1,7 +1,7 @@
1
1
  export const registerListCollaborators = (server, { client }) => {
2
2
  server.registerTool('list_collaborators', {
3
3
  title: 'List Collaborators',
4
- description: 'List users who have access to this base. Returns email (internal user ID) and display name. Use the email values when writing to collaborator columns.',
4
+ description: 'List users who have access to this base. Returns email (internal user ID) and display name. Use the email values when writing to collaborator columns. Call this once to resolve @auth.local addresses in collaborator columns before displaying them to the user.',
5
5
  inputSchema: {
6
6
  type: 'object',
7
7
  properties: {},
@@ -1 +1 @@
1
- {"version":3,"file":"listCollaborators.js","sourceRoot":"","sources":["../../../src/mcp/tools/listCollaborators.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAkB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAC3E,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,wJAAwJ;QACrK,WAAW,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACf;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1G,EACD,KAAK,IAAI,EAAE;QACP,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAA;QAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;IACvE,CAAC,CACJ,CAAA;AACL,CAAC,CAAA"}
1
+ {"version":3,"file":"listCollaborators.js","sourceRoot":"","sources":["../../../src/mcp/tools/listCollaborators.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,yBAAyB,GAAkB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAC3E,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;QACI,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,oQAAoQ;QACjR,WAAW,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACf;QACD,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1G,EACD,KAAK,IAAI,EAAE;QACP,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAA;QAC9C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;IACvE,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,aAuB9B,CAAA"}
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,aAsC9B,CAAA"}
@@ -7,7 +7,22 @@ const InputSchema = z.object({
7
7
  export const registerQuerySql = (server, { client, getInputSchema }) => {
8
8
  server.registerTool('query_sql', {
9
9
  title: 'Query SQL',
10
- description: 'Execute raw SQL queries against SeaTable. Supports SELECT, INSERT, UPDATE, DELETE. Use ? placeholders for parameters to prevent SQL injection.',
10
+ description: `Execute SQL queries against SeaTable (SELECT, UPDATE, DELETE, INSERT). Use ? placeholders for parameters.
11
+
12
+ Syntax rules:
13
+ - Quote table/column names with backticks: \`Table Name\`, \`Column Name\` (not double quotes).
14
+ - SELECT returns max 100 rows by default. Use LIMIT to get more (up to 10,000).
15
+ - ORDER BY columns must appear in the SELECT field list.
16
+ - No JOIN keyword. Use implicit joins: FROM \`T1\`, \`T2\` WHERE \`T1\`.\`col\` = \`T2\`.\`col\`. Only inner joins are supported.
17
+ - No subqueries.
18
+ - Empty strings are treated as NULL. Use IS NULL / IS NOT NULL instead of = "".
19
+ - Date functions available in SELECT only: date(year, month, day), year(), month(), day(), dateAdd(), now(), today().
20
+
21
+ UPDATE limitations:
22
+ - SET only accepts literal values (strings, numbers, booleans). No functions (date(), now(), upper()…) and no expressions (Amount + 10) allowed.
23
+ - Columns not updatable via SQL: image, file, formula, link, link-formula, geolocation, auto-number, button. Use the dedicated tools (upload_file, link_rows) instead.
24
+
25
+ If a query fails, do not retry with similar syntax. Switch to an alternative tool (e.g. update_rows, find_rows) instead.`,
11
26
  inputSchema: getInputSchema(InputSchema),
12
27
  annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
13
28
  }, async (args) => {
@@ -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,gJAAgJ;QAC7J,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;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;;;;;;;;;;;;;;;yHAegG;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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seatable/mcp-seatable",
3
- "version": "1.3.3",
3
+ "version": "1.3.5",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "mcpName": "io.github.seatable/seatable",
@@ -64,7 +64,7 @@
64
64
  "express-rate-limit": "^8.3.0"
65
65
  },
66
66
  "engines": {
67
- "node": ">=18"
67
+ "node": ">=20"
68
68
  },
69
69
  "dependencies": {
70
70
  "@modelcontextprotocol/sdk": "^1.17.4",