@rashidazarang/airtable-mcp 3.1.0 → 3.2.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.
Files changed (100) hide show
  1. package/README.md +62 -25
  2. package/bin/airtable-mcp.js +12 -32
  3. package/dist/typescript/airtable-mcp-server.js +77 -0
  4. package/dist/typescript/airtable-mcp-server.js.map +1 -0
  5. package/dist/typescript/app/airtable-client.js +325 -0
  6. package/dist/typescript/app/airtable-client.js.map +1 -0
  7. package/dist/typescript/app/config.js +141 -0
  8. package/dist/typescript/app/config.js.map +1 -0
  9. package/dist/typescript/app/context.js +3 -0
  10. package/dist/typescript/app/context.js.map +1 -0
  11. package/dist/typescript/app/exceptions.js +85 -0
  12. package/dist/typescript/app/exceptions.js.map +1 -0
  13. package/dist/typescript/app/governance.js +58 -0
  14. package/dist/typescript/app/governance.js.map +1 -0
  15. package/dist/typescript/app/logger.js +47 -0
  16. package/dist/typescript/app/logger.js.map +1 -0
  17. package/dist/typescript/app/rateLimiter.js +37 -0
  18. package/dist/typescript/app/rateLimiter.js.map +1 -0
  19. package/dist/typescript/app/tools/create.js +54 -0
  20. package/dist/typescript/app/tools/create.js.map +1 -0
  21. package/dist/typescript/app/tools/describe.js +146 -0
  22. package/dist/typescript/app/tools/describe.js.map +1 -0
  23. package/dist/typescript/app/tools/handleError.js +54 -0
  24. package/dist/typescript/app/tools/handleError.js.map +1 -0
  25. package/dist/typescript/app/tools/index.js +24 -0
  26. package/dist/typescript/app/tools/index.js.map +1 -0
  27. package/dist/typescript/app/tools/listBases.js +52 -0
  28. package/dist/typescript/app/tools/listBases.js.map +1 -0
  29. package/dist/typescript/app/tools/listExceptions.js +18 -0
  30. package/dist/typescript/app/tools/listExceptions.js.map +1 -0
  31. package/dist/typescript/app/tools/listGovernance.js +17 -0
  32. package/dist/typescript/app/tools/listGovernance.js.map +1 -0
  33. package/dist/typescript/app/tools/query.js +126 -0
  34. package/dist/typescript/app/tools/query.js.map +1 -0
  35. package/dist/typescript/app/tools/update.js +56 -0
  36. package/dist/typescript/app/tools/update.js.map +1 -0
  37. package/dist/typescript/app/tools/upsert.js +65 -0
  38. package/dist/typescript/app/tools/upsert.js.map +1 -0
  39. package/dist/typescript/app/tools/webhooks.js +44 -0
  40. package/dist/typescript/app/tools/webhooks.js.map +1 -0
  41. package/dist/typescript/app/types.js +282 -0
  42. package/dist/typescript/app/types.js.map +1 -0
  43. package/dist/typescript/apps-sdk/mappers.js +70 -0
  44. package/dist/typescript/apps-sdk/mappers.js.map +1 -0
  45. package/dist/typescript/errors.js +75 -0
  46. package/dist/typescript/errors.js.map +1 -0
  47. package/dist/typescript/index.js +27 -0
  48. package/dist/typescript/index.js.map +1 -0
  49. package/package.json +49 -30
  50. package/tsconfig.json +10 -4
  51. package/types/typescript/airtable-mcp-server.d.ts +2 -0
  52. package/types/typescript/app/airtable-client.d.ts +49 -0
  53. package/types/typescript/app/config.d.ts +16 -0
  54. package/types/typescript/app/context.d.ts +12 -0
  55. package/types/typescript/app/exceptions.d.ts +12 -0
  56. package/types/typescript/app/governance.d.ts +18 -0
  57. package/types/typescript/app/logger.d.ts +13 -0
  58. package/types/typescript/app/rateLimiter.d.ts +13 -0
  59. package/types/typescript/app/tools/create.d.ts +3 -0
  60. package/types/typescript/app/tools/describe.d.ts +3 -0
  61. package/types/typescript/app/tools/handleError.d.ts +8 -0
  62. package/types/typescript/app/tools/index.d.ts +3 -0
  63. package/types/typescript/app/tools/listBases.d.ts +33 -0
  64. package/types/typescript/app/tools/listExceptions.d.ts +3 -0
  65. package/types/typescript/app/tools/listGovernance.d.ts +3 -0
  66. package/types/typescript/app/tools/query.d.ts +3 -0
  67. package/types/typescript/app/tools/update.d.ts +3 -0
  68. package/types/typescript/app/tools/upsert.d.ts +3 -0
  69. package/types/typescript/app/tools/webhooks.d.ts +3 -0
  70. package/types/typescript/app/types.d.ts +830 -0
  71. package/types/typescript/apps-sdk/mappers.d.ts +53 -0
  72. package/types/typescript/errors.d.ts +55 -0
  73. package/types/typescript/index.d.ts +10 -0
  74. package/types/typescript/prompt-templates.d.ts +5 -0
  75. package/types/typescript/tools-schemas.d.ts +5 -0
  76. package/airtable_simple.js +0 -1561
  77. package/airtable_simple_production.js +0 -1564
  78. package/dist/airtable-mcp-server.js +0 -660
  79. package/dist/airtable-mcp-server.js.map +0 -1
  80. package/dist/test-suite.js +0 -421
  81. package/dist/test-suite.js.map +0 -1
  82. package/examples/airtable-crud-example.js +0 -203
  83. package/examples/building-mcp.md +0 -6666
  84. package/examples/claude_config.json +0 -4
  85. package/examples/claude_simple_config.json +0 -7
  86. package/examples/env-demo.js +0 -172
  87. package/examples/example-tasks-update.json +0 -23
  88. package/examples/example-tasks.json +0 -26
  89. package/examples/example_usage.md +0 -124
  90. package/examples/python_debug_patch.txt +0 -27
  91. package/examples/sample-transform.js +0 -76
  92. package/examples/typescript/advanced-ai-prompts.ts +0 -447
  93. package/examples/typescript/basic-usage.ts +0 -174
  94. package/examples/typescript/claude-desktop-config.json +0 -29
  95. package/examples/windsurf_mcp_config.json +0 -17
  96. package/types/ai-prompts.d.ts +0 -321
  97. package/types/airtable-mcp-server.d.ts +0 -52
  98. package/types/index.d.ts +0 -357
  99. package/types/tools.d.ts +0 -514
  100. /package/types/{test-suite.d.ts → typescript/test-suite.d.ts} +0 -0
@@ -0,0 +1,282 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.governanceOutputSchema = exports.listExceptionsOutputSchema = exports.exceptionItemSchema = exports.listExceptionsInputSchema = exports.upsertOutputSchema = exports.upsertInputSchema = exports.updateInputSchema = exports.updateOutputSchema = exports.createOutputSchema = exports.createInputSchema = exports.queryOutputSchema = exports.queryInputShape = exports.queryInputSchema = exports.describeOutputSchema = exports.describeInputShape = exports.describeInputSchema = void 0;
4
+ const zod_1 = require("zod");
5
+ /**
6
+ * Shared Zod schemas and TypeScript types for Airtable Brain tools.
7
+ * Keep these aligned with the JSON Schemas under docs/prd/schemas.
8
+ */
9
+ const describeInputBase = zod_1.z
10
+ .object({
11
+ scope: zod_1.z.enum(['base', 'table']),
12
+ baseId: zod_1.z.string().min(1, 'baseId is required'),
13
+ table: zod_1.z
14
+ .string()
15
+ .min(1, 'table is required when scope=table')
16
+ .optional(),
17
+ includeFields: zod_1.z.boolean().optional().default(true),
18
+ includeViews: zod_1.z.boolean().optional().default(false)
19
+ })
20
+ .strict();
21
+ exports.describeInputSchema = describeInputBase.superRefine((data, ctx) => {
22
+ if (data.scope === 'table' && !data.table) {
23
+ ctx.addIssue({
24
+ code: zod_1.z.ZodIssueCode.custom,
25
+ path: ['table'],
26
+ message: 'table is required when scope is "table"'
27
+ });
28
+ }
29
+ });
30
+ exports.describeInputShape = describeInputBase.shape;
31
+ const describeFieldSchema = zod_1.z
32
+ .object({
33
+ id: zod_1.z.string(),
34
+ name: zod_1.z.string(),
35
+ type: zod_1.z.string(),
36
+ options: zod_1.z.record(zod_1.z.unknown()).optional()
37
+ })
38
+ .passthrough();
39
+ const describeTableSchema = zod_1.z
40
+ .object({
41
+ id: zod_1.z.string(),
42
+ name: zod_1.z.string(),
43
+ description: zod_1.z.string().optional(),
44
+ primaryFieldId: zod_1.z.string().optional(),
45
+ fields: zod_1.z.array(describeFieldSchema).optional(),
46
+ views: zod_1.z.array(zod_1.z.record(zod_1.z.unknown())).optional()
47
+ })
48
+ .passthrough();
49
+ exports.describeOutputSchema = zod_1.z
50
+ .object({
51
+ base: zod_1.z
52
+ .object({
53
+ id: zod_1.z.string(),
54
+ name: zod_1.z.string()
55
+ })
56
+ .passthrough(),
57
+ tables: zod_1.z.array(describeTableSchema).optional(),
58
+ views: zod_1.z.array(zod_1.z.record(zod_1.z.unknown())).optional()
59
+ })
60
+ .strict();
61
+ const sortDirectionSchema = zod_1.z.enum(['asc', 'desc']);
62
+ const queryInputBase = zod_1.z
63
+ .object({
64
+ baseId: zod_1.z.string().min(1, 'baseId is required'),
65
+ table: zod_1.z.string().min(1, 'table is required'),
66
+ fields: zod_1.z.array(zod_1.z.string().min(1)).optional(),
67
+ filterByFormula: zod_1.z.string().optional(),
68
+ view: zod_1.z.string().optional(),
69
+ sorts: zod_1.z
70
+ .array(zod_1.z
71
+ .object({
72
+ field: zod_1.z.string().min(1),
73
+ direction: sortDirectionSchema.optional().default('asc')
74
+ })
75
+ .strict())
76
+ .optional(),
77
+ pageSize: zod_1.z
78
+ .number()
79
+ .int()
80
+ .min(1)
81
+ .max(100)
82
+ .optional(),
83
+ maxRecords: zod_1.z
84
+ .number()
85
+ .int()
86
+ .min(1)
87
+ .optional(),
88
+ offset: zod_1.z.string().optional(),
89
+ returnFieldsByFieldId: zod_1.z.boolean().optional().default(false)
90
+ })
91
+ .strict();
92
+ exports.queryInputSchema = queryInputBase;
93
+ exports.queryInputShape = queryInputBase.shape;
94
+ const recordSchema = zod_1.z
95
+ .object({
96
+ id: zod_1.z.string(),
97
+ createdTime: zod_1.z.string().optional(),
98
+ fields: zod_1.z.record(zod_1.z.unknown())
99
+ })
100
+ .strict();
101
+ exports.queryOutputSchema = zod_1.z
102
+ .object({
103
+ records: zod_1.z.array(recordSchema),
104
+ offset: zod_1.z.string().optional(),
105
+ summary: zod_1.z
106
+ .object({
107
+ returned: zod_1.z.number().int().nonnegative(),
108
+ hasMore: zod_1.z.boolean()
109
+ })
110
+ .strict()
111
+ .optional()
112
+ })
113
+ .strict();
114
+ exports.createInputSchema = zod_1.z
115
+ .object({
116
+ baseId: zod_1.z.string().min(1),
117
+ table: zod_1.z.string().min(1),
118
+ records: zod_1.z
119
+ .array(zod_1.z
120
+ .object({
121
+ fields: zod_1.z.record(zod_1.z.unknown())
122
+ })
123
+ .strict())
124
+ .min(1),
125
+ typecast: zod_1.z.boolean().optional().default(false),
126
+ idempotencyKey: zod_1.z.string().min(1).optional(),
127
+ dryRun: zod_1.z.boolean().optional().default(false)
128
+ })
129
+ .strict();
130
+ const createDiffSchema = zod_1.z
131
+ .object({
132
+ added: zod_1.z.number().int().nonnegative(),
133
+ updated: zod_1.z.number().int().nonnegative(),
134
+ unchanged: zod_1.z.number().int().nonnegative()
135
+ })
136
+ .strict();
137
+ exports.createOutputSchema = zod_1.z
138
+ .object({
139
+ diff: createDiffSchema,
140
+ records: zod_1.z.array(recordSchema).optional(),
141
+ dryRun: zod_1.z.boolean(),
142
+ warnings: zod_1.z.array(zod_1.z.string()).optional()
143
+ })
144
+ .strict();
145
+ const conflictSchema = zod_1.z
146
+ .object({
147
+ id: zod_1.z.string(),
148
+ field: zod_1.z.string(),
149
+ before: zod_1.z.unknown().optional(),
150
+ after: zod_1.z.unknown().optional(),
151
+ current: zod_1.z.unknown()
152
+ })
153
+ .strict();
154
+ const mutationDiffSchema = zod_1.z
155
+ .object({
156
+ added: zod_1.z.number().int().nonnegative(),
157
+ updated: zod_1.z.number().int().nonnegative(),
158
+ unchanged: zod_1.z.number().int().nonnegative(),
159
+ conflicts: zod_1.z.number().int().nonnegative()
160
+ })
161
+ .strict();
162
+ exports.updateOutputSchema = zod_1.z
163
+ .object({
164
+ diff: mutationDiffSchema,
165
+ records: zod_1.z.array(recordSchema).optional(),
166
+ dryRun: zod_1.z.boolean(),
167
+ conflicts: zod_1.z.array(conflictSchema).optional()
168
+ })
169
+ .strict();
170
+ exports.updateInputSchema = zod_1.z
171
+ .object({
172
+ baseId: zod_1.z.string().min(1),
173
+ table: zod_1.z.string().min(1),
174
+ records: zod_1.z
175
+ .array(zod_1.z
176
+ .object({
177
+ id: zod_1.z.string(),
178
+ fields: zod_1.z.record(zod_1.z.unknown())
179
+ })
180
+ .strict())
181
+ .min(1),
182
+ typecast: zod_1.z.boolean().optional().default(false),
183
+ idempotencyKey: zod_1.z.string().min(1).optional(),
184
+ dryRun: zod_1.z.boolean().optional().default(false),
185
+ conflictStrategy: zod_1.z
186
+ .enum(['fail_on_conflict', 'server_merge', 'client_merge'])
187
+ .optional()
188
+ .default('fail_on_conflict'),
189
+ ifUnchangedHash: zod_1.z.string().optional()
190
+ })
191
+ .strict();
192
+ exports.upsertInputSchema = zod_1.z
193
+ .object({
194
+ baseId: zod_1.z.string().min(1),
195
+ table: zod_1.z.string().min(1),
196
+ records: zod_1.z
197
+ .array(zod_1.z
198
+ .object({
199
+ fields: zod_1.z.record(zod_1.z.unknown())
200
+ })
201
+ .strict())
202
+ .min(1),
203
+ performUpsert: zod_1.z
204
+ .object({
205
+ fieldsToMergeOn: zod_1.z.array(zod_1.z.string().min(1)).min(1)
206
+ })
207
+ .strict(),
208
+ typecast: zod_1.z.boolean().optional().default(false),
209
+ idempotencyKey: zod_1.z.string().min(1).optional(),
210
+ dryRun: zod_1.z.boolean().optional().default(false),
211
+ conflictStrategy: zod_1.z
212
+ .enum(['fail_on_conflict', 'server_merge', 'client_merge'])
213
+ .optional()
214
+ .default('fail_on_conflict')
215
+ })
216
+ .strict();
217
+ exports.upsertOutputSchema = zod_1.z
218
+ .object({
219
+ diff: mutationDiffSchema,
220
+ records: zod_1.z.array(recordSchema).optional(),
221
+ dryRun: zod_1.z.boolean(),
222
+ conflicts: zod_1.z.array(conflictSchema).optional()
223
+ })
224
+ .strict();
225
+ exports.listExceptionsInputSchema = zod_1.z
226
+ .object({
227
+ since: zod_1.z.string().optional(),
228
+ severity: zod_1.z.enum(['info', 'warning', 'error']).optional(),
229
+ limit: zod_1.z.number().int().min(1).max(500).optional().default(100),
230
+ cursor: zod_1.z.string().optional()
231
+ })
232
+ .strict();
233
+ exports.exceptionItemSchema = zod_1.z
234
+ .object({
235
+ id: zod_1.z.string(),
236
+ timestamp: zod_1.z.string(),
237
+ severity: zod_1.z.enum(['info', 'warning', 'error']),
238
+ category: zod_1.z.enum(['rate_limit', 'validation', 'auth', 'conflict', 'schema_drift', 'other']),
239
+ summary: zod_1.z.string(),
240
+ details: zod_1.z.string().optional(),
241
+ proposedFix: zod_1.z.record(zod_1.z.unknown()).optional()
242
+ })
243
+ .strict();
244
+ exports.listExceptionsOutputSchema = zod_1.z
245
+ .object({
246
+ items: zod_1.z.array(exports.exceptionItemSchema),
247
+ cursor: zod_1.z.string().optional()
248
+ })
249
+ .strict();
250
+ const allowedOperations = ['describe', 'query', 'create', 'update', 'upsert'];
251
+ exports.governanceOutputSchema = zod_1.z
252
+ .object({
253
+ allowedBases: zod_1.z.array(zod_1.z.string()),
254
+ allowedTables: zod_1.z
255
+ .array(zod_1.z
256
+ .object({
257
+ baseId: zod_1.z.string(),
258
+ table: zod_1.z.string()
259
+ })
260
+ .strict())
261
+ .optional()
262
+ .default([]),
263
+ allowedOperations: zod_1.z
264
+ .array(zod_1.z.enum(allowedOperations))
265
+ .default([...allowedOperations]),
266
+ piiFields: zod_1.z
267
+ .array(zod_1.z
268
+ .object({
269
+ baseId: zod_1.z.string(),
270
+ table: zod_1.z.string(),
271
+ field: zod_1.z.string(),
272
+ policy: zod_1.z.enum(['mask', 'hash', 'drop'])
273
+ })
274
+ .strict())
275
+ .optional()
276
+ .default([]),
277
+ redactionPolicy: zod_1.z.enum(['mask_all_pii', 'mask_on_inline', 'none']).default('mask_on_inline'),
278
+ loggingPolicy: zod_1.z.enum(['errors_only', 'minimal', 'verbose']).default('minimal'),
279
+ retentionDays: zod_1.z.number().int().min(0).default(7)
280
+ })
281
+ .strict();
282
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/typescript/app/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,70 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.toInlineResultCard = toInlineResultCard;
4
+ exports.toFullscreenGrid = toFullscreenGrid;
5
+ exports.buildDiffModalForCreate = buildDiffModalForCreate;
6
+ exports.buildDiffModalForUpdate = buildDiffModalForUpdate;
7
+ function toInlineResultCard(table, result) {
8
+ const sample = result.records.slice(0, 5);
9
+ const colSet = new Set();
10
+ for (const r of sample)
11
+ Object.keys(r.fields || {}).forEach((k) => colSet.add(k));
12
+ const columns = Array.from(colSet).map((k) => ({ key: k, label: k }));
13
+ return {
14
+ title: `${table}`,
15
+ subtitle: sample.length > 0 && typeof result.summary?.returned === 'number'
16
+ ? `Showing ${sample.length} of ${result.summary.returned}${result.summary.hasMore ? '+' : ''}`
17
+ : undefined,
18
+ columns,
19
+ rows: sample.map((r) => ({ id: r.id, ...r.fields })),
20
+ pagination: { hasMore: Boolean(result.summary?.hasMore), nextOffset: result.offset },
21
+ actions: ['view_fullscreen', 'export_csv'],
22
+ state: sample.length === 0 ? 'empty' : 'ready'
23
+ };
24
+ }
25
+ function toFullscreenGrid(_table, result, selection = []) {
26
+ const colSet = new Set();
27
+ for (const r of result.records)
28
+ Object.keys(r.fields || {}).forEach((k) => colSet.add(k));
29
+ const columns = Array.from(colSet).map((k) => ({ key: k, label: k }));
30
+ return {
31
+ columns,
32
+ rows: result.records.map((r) => ({ id: r.id, ...(r.fields || {}) })),
33
+ filters: {},
34
+ sorts: [],
35
+ selection,
36
+ toolbarActions: ['propose_edit', 'upsert_by_key', 'export_csv'],
37
+ state: result.records.length === 0 ? 'empty' : 'ready'
38
+ };
39
+ }
40
+ function buildDiffModalForCreate(output, idempotencyKey) {
41
+ const changes = [];
42
+ for (const r of output.records || []) {
43
+ const fields = r.fields || {};
44
+ for (const [field, after] of Object.entries(fields)) {
45
+ changes.push({ recordId: r.id || 'new', field, before: null, after, status: 'add' });
46
+ }
47
+ }
48
+ return {
49
+ changes,
50
+ idempotencyKey,
51
+ confirmAction: 'create',
52
+ cancelAction: 'close'
53
+ };
54
+ }
55
+ function buildDiffModalForUpdate(output, idempotencyKey) {
56
+ const changes = [];
57
+ for (const r of output.records || []) {
58
+ const fields = r.fields || {};
59
+ for (const [field, after] of Object.entries(fields)) {
60
+ changes.push({ recordId: r.id, field, before: undefined, after, status: 'update' });
61
+ }
62
+ }
63
+ return {
64
+ changes,
65
+ idempotencyKey,
66
+ confirmAction: 'update',
67
+ cancelAction: 'close'
68
+ };
69
+ }
70
+ //# sourceMappingURL=mappers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../src/typescript/apps-sdk/mappers.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ "use strict";
2
+ /**
3
+ * Error taxonomy aligned with Airtable Brain guardrails.
4
+ *
5
+ * All tool errors should use these types so the LLM can reason about
6
+ * retry behaviour and user messaging. Avoid leaking raw Airtable payloads
7
+ * through error messages.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.GovernanceError = exports.InternalServerError = exports.NotFoundError = exports.ConflictError = exports.AuthError = exports.AirtableValidationError = exports.RateLimitError = exports.AirtableBrainError = void 0;
11
+ class AirtableBrainError extends Error {
12
+ constructor(code, message, options = {}) {
13
+ super(message);
14
+ this.name = code;
15
+ this.code = code;
16
+ if (options.cause !== undefined) {
17
+ this.cause = options.cause;
18
+ }
19
+ if (options.status !== undefined) {
20
+ this.status = options.status;
21
+ }
22
+ if (options.retryAfterMs !== undefined) {
23
+ this.retryAfterMs = options.retryAfterMs;
24
+ }
25
+ this.context = options.context ?? {};
26
+ }
27
+ withContext(context) {
28
+ Object.assign(this.context, context);
29
+ return this;
30
+ }
31
+ }
32
+ exports.AirtableBrainError = AirtableBrainError;
33
+ class RateLimitError extends AirtableBrainError {
34
+ constructor(message, options = {}) {
35
+ super('RateLimited', message, options);
36
+ }
37
+ }
38
+ exports.RateLimitError = RateLimitError;
39
+ class AirtableValidationError extends AirtableBrainError {
40
+ constructor(message, options = {}) {
41
+ super('ValidationError', message, options);
42
+ }
43
+ }
44
+ exports.AirtableValidationError = AirtableValidationError;
45
+ class AuthError extends AirtableBrainError {
46
+ constructor(message, options = {}) {
47
+ super('AuthError', message, options);
48
+ }
49
+ }
50
+ exports.AuthError = AuthError;
51
+ class ConflictError extends AirtableBrainError {
52
+ constructor(message, options = {}) {
53
+ super('ConflictError', message, options);
54
+ }
55
+ }
56
+ exports.ConflictError = ConflictError;
57
+ class NotFoundError extends AirtableBrainError {
58
+ constructor(message, options = {}) {
59
+ super('NotFound', message, options);
60
+ }
61
+ }
62
+ exports.NotFoundError = NotFoundError;
63
+ class InternalServerError extends AirtableBrainError {
64
+ constructor(message, options = {}) {
65
+ super('InternalError', message, options);
66
+ }
67
+ }
68
+ exports.InternalServerError = InternalServerError;
69
+ class GovernanceError extends AirtableBrainError {
70
+ constructor(message, options = {}) {
71
+ super('GovernanceError', message, options);
72
+ }
73
+ }
74
+ exports.GovernanceError = GovernanceError;
75
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/typescript/errors.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA8BH,MAAa,kBAAmB,SAAQ,KAAK;IAM3C,YAAY,IAAuB,EAAE,OAAe,EAAE,UAAgC,EAAE;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAoC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,WAAW,CAAC,OAA8B;QACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA1BD,gDA0BC;AAED,MAAa,cAAe,SAAQ,kBAAkB;IACpD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAJD,wCAIC;AAED,MAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAJD,0DAIC;AAED,MAAa,SAAU,SAAQ,kBAAkB;IAC/C,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACF;AAJD,8BAIC;AAED,MAAa,aAAc,SAAQ,kBAAkB;IACnD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAJD,sCAIC;AAED,MAAa,aAAc,SAAQ,kBAAkB;IACnD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF;AAJD,sCAIC;AAED,MAAa,mBAAoB,SAAQ,kBAAkB;IACzD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAJD,kDAIC;AAED,MAAa,eAAgB,SAAQ,kBAAkB;IACrD,YAAY,OAAe,EAAE,UAAgC,EAAE;QAC7D,KAAK,CAAC,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AAJD,0CAIC"}
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+ /**
3
+ * Airtable MCP Server - Main Export
4
+ *
5
+ * This module exports the main server functionality for programmatic use.
6
+ * For CLI usage, use the bin/airtable-mcp.js executable.
7
+ */
8
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
9
+ if (k2 === undefined) k2 = k;
10
+ var desc = Object.getOwnPropertyDescriptor(m, k);
11
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
12
+ desc = { enumerable: true, get: function() { return m[k]; } };
13
+ }
14
+ Object.defineProperty(o, k2, desc);
15
+ }) : (function(o, m, k, k2) {
16
+ if (k2 === undefined) k2 = k;
17
+ o[k2] = m[k];
18
+ }));
19
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
20
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
21
+ };
22
+ Object.defineProperty(exports, "__esModule", { value: true });
23
+ exports.start = void 0;
24
+ var airtable_mcp_server_1 = require("./airtable-mcp-server");
25
+ Object.defineProperty(exports, "start", { enumerable: true, get: function () { return airtable_mcp_server_1.start; } });
26
+ __exportStar(require("./errors"), exports);
27
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typescript/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,6DAA8C;AAArC,4GAAA,KAAK,OAAA;AACd,2CAAyB"}
package/package.json CHANGED
@@ -1,33 +1,42 @@
1
1
  {
2
2
  "name": "@rashidazarang/airtable-mcp",
3
- "version": "3.1.0",
3
+ "version": "3.2.5",
4
4
  "description": "Advanced AI-powered Airtable MCP server with TypeScript support, intelligent analytics, predictive modeling, and enterprise automation capabilities",
5
- "main": "airtable_simple_production.js",
5
+ "main": "dist/typescript/index.js",
6
6
  "exports": {
7
7
  ".": {
8
- "import": "./dist/airtable-mcp-server.js",
9
- "require": "./airtable_simple_production.js",
10
- "types": "./types/index.d.ts"
8
+ "import": "./dist/typescript/index.js",
9
+ "require": "./dist/typescript/index.js",
10
+ "types": "./types/typescript/index.d.ts"
11
11
  },
12
- "./types": "./types/index.d.ts",
13
- "./types/*": "./types/*.d.ts"
12
+ "./types": "./types/typescript/app/types.d.ts",
13
+ "./types/*": "./types/typescript/**/*.d.ts"
14
14
  },
15
15
  "bin": {
16
- "airtable-mcp": "./airtable_simple_production.js",
17
- "airtable-mcp-ts": "./dist/airtable-mcp-server.js"
16
+ "airtable-mcp": "./bin/airtable-mcp.js",
17
+ "airtable-mcp-cli": "./bin/airtable-crud-cli.js"
18
18
  },
19
19
  "scripts": {
20
- "start": "node airtable_simple_production.js",
21
- "start:ts": "node dist/airtable-mcp-server.js",
22
- "start:python": "python3.10 inspector_server.py",
23
- "test": "node test_mcp_comprehensive.js",
24
- "test:quick": "./quick_test.sh",
25
- "test:types": "tsc --noEmit",
26
- "test:ts": "npm run build && node dist/test-suite.js",
27
20
  "build": "tsc",
28
21
  "build:watch": "tsc --watch",
29
- "dev": "node airtable_simple_production.js --token YOUR_TOKEN --base YOUR_BASE_ID",
30
- "dev:ts": "npm run build && npm run start:ts"
22
+ "clean": "rm -rf dist",
23
+ "prebuild": "npm run clean",
24
+ "start": "node dist/typescript/airtable-mcp-server.js",
25
+ "start:dev": "ts-node src/typescript/airtable-mcp-server.ts",
26
+ "start:js": "node src/javascript/airtable_simple_production.js",
27
+ "start:python": "python3 src/python/inspector_server.py",
28
+ "test": "jest",
29
+ "test:unit": "jest tests/unit",
30
+ "test:integration": "jest tests/integration",
31
+ "test:e2e": "jest tests/e2e",
32
+ "test:types": "tsc --noEmit",
33
+ "lint": "eslint src/**/*.{js,ts}",
34
+ "lint:fix": "eslint src/**/*.{js,ts} --fix",
35
+ "format": "prettier --write \"src/**/*.{js,ts,json,md}\"",
36
+ "format:check": "prettier --check \"src/**/*.{js,ts,json,md}\"",
37
+ "dev": "nodemon --watch src --exec ts-node src/typescript/airtable-mcp-server.ts",
38
+ "prepare": "npm run build",
39
+ "prepublishOnly": "npm run build"
31
40
  },
32
41
  "keywords": [
33
42
  "airtable",
@@ -38,35 +47,45 @@
38
47
  "ai",
39
48
  "database",
40
49
  "typescript",
41
- "types"
50
+ "automation",
51
+ "enterprise",
52
+ "analytics"
42
53
  ],
43
54
  "files": [
44
- "airtable_simple.js",
45
- "airtable_simple_production.js",
46
55
  "dist/",
47
56
  "types/",
57
+ "bin/",
48
58
  "README.md",
49
59
  "LICENSE",
50
60
  "package.json",
51
- "tsconfig.json",
52
- "examples/",
53
- "bin/"
61
+ "tsconfig.json"
54
62
  ],
55
- "types": "types/index.d.ts",
63
+ "types": "types/typescript/index.d.ts",
56
64
  "author": "Rashid Azarang",
57
65
  "license": "MIT",
58
66
  "dependencies": {
67
+ "@modelcontextprotocol/sdk": "1.19.1",
59
68
  "@smithery/cli": "^1.0.0",
60
- "airtable": "^0.12.2",
61
- "dotenv": "^16.0.0"
69
+ "dotenv": "^16.0.0",
70
+ "zod": "^3.23.8"
62
71
  },
63
72
  "devDependencies": {
64
- "typescript": "^5.3.0",
73
+ "@types/dotenv": "^8.2.0",
74
+ "@types/jest": "^29.5.0",
65
75
  "@types/node": "^20.10.0",
66
- "@types/dotenv": "^8.2.0"
76
+ "@typescript-eslint/eslint-plugin": "^6.0.0",
77
+ "@typescript-eslint/parser": "^6.0.0",
78
+ "eslint": "^8.50.0",
79
+ "eslint-config-prettier": "^9.0.0",
80
+ "jest": "^29.7.0",
81
+ "nodemon": "^3.0.0",
82
+ "prettier": "^3.0.0",
83
+ "ts-jest": "^29.1.0",
84
+ "ts-node": "^10.9.0",
85
+ "typescript": "^5.3.0"
67
86
  },
68
87
  "engines": {
69
- "node": ">=14.0.0"
88
+ "node": ">=18.0.0"
70
89
  },
71
90
  "repository": {
72
91
  "type": "git",
package/tsconfig.json CHANGED
@@ -23,16 +23,22 @@
23
23
  "exactOptionalPropertyTypes": true,
24
24
  "noImplicitOverride": true,
25
25
  "noPropertyAccessFromIndexSignature": false,
26
- "noUncheckedIndexedAccess": true
26
+ "noUncheckedIndexedAccess": true,
27
+ "types": []
27
28
  },
28
29
  "include": [
29
- "src/**/*"
30
+ "src/typescript/**/*"
30
31
  ],
31
32
  "exclude": [
32
33
  "node_modules",
33
34
  "dist",
34
35
  "types",
35
36
  "**/*.test.ts",
36
- "**/*.spec.ts"
37
+ "**/*.spec.ts",
38
+ "src/javascript/**/*",
39
+ "src/python/**/*",
40
+ "src/typescript/prompt-templates.ts",
41
+ "src/typescript/tools-schemas.ts",
42
+ "src/typescript/**/*.d.ts"
37
43
  ]
38
- }
44
+ }
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export declare function start(): Promise<void>;