@rashidazarang/airtable-mcp 3.0.0 → 3.2.5

package/dist/typescript/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Airtable MCP Server - Main Export
+ *
+ * This module exports the main server functionality for programmatic use.
+ * For CLI usage, use the bin/airtable-mcp.js executable.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.start = void 0;
+var airtable_mcp_server_1 = require("./airtable-mcp-server");
+Object.defineProperty(exports, "start", { enumerable: true, get: function () { return airtable_mcp_server_1.start; } });
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/typescript/index.js.map

@@ -0,0 +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

@@ -1,17 +1,42 @@
 {
   "name": "@rashidazarang/airtable-mcp",
-  "version": "3.0.0",
-  "description": "Advanced AI-powered Airtable MCP server with intelligent analytics, predictive modeling, and enterprise automation capabilities",
-  "main": "airtable_simple_production.js",
+  "version": "3.2.5",
+  "description": "Advanced AI-powered Airtable MCP server with TypeScript support, intelligent analytics, predictive modeling, and enterprise automation capabilities",
+  "main": "dist/typescript/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/typescript/index.js",
+      "require": "./dist/typescript/index.js",
+      "types": "./types/typescript/index.d.ts"
+    },
+    "./types": "./types/typescript/app/types.d.ts",
+    "./types/*": "./types/typescript/**/*.d.ts"
+  },
   "bin": {
-    "airtable-mcp": "./airtable_simple_production.js"
+    "airtable-mcp": "./bin/airtable-mcp.js",
+    "airtable-mcp-cli": "./bin/airtable-crud-cli.js"
   },
   "scripts": {
-    "start": "node airtable_simple_production.js",
-    "start:python": "python3.10 inspector_server.py",
-    "test": "node test_mcp_comprehensive.js",
-    "test:quick": "./quick_test.sh",
-    "dev": "node airtable_simple_production.js --token YOUR_TOKEN --base YOUR_BASE_ID"
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "start": "node dist/typescript/airtable-mcp-server.js",
+    "start:dev": "ts-node src/typescript/airtable-mcp-server.ts",
+    "start:js": "node src/javascript/airtable_simple_production.js",
+    "start:python": "python3 src/python/inspector_server.py",
+    "test": "jest",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration",
+    "test:e2e": "jest tests/e2e",
+    "test:types": "tsc --noEmit",
+    "lint": "eslint src/**/*.{js,ts}",
+    "lint:fix": "eslint src/**/*.{js,ts} --fix",
+    "format": "prettier --write \"src/**/*.{js,ts,json,md}\"",
+    "format:check": "prettier --check \"src/**/*.{js,ts,json,md}\"",
+    "dev": "nodemon --watch src --exec ts-node src/typescript/airtable-mcp-server.ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "airtable",
@@ -20,26 +45,47 @@
     "claude-desktop",
     "anthropic",
     "ai",
-    "database"
+    "database",
+    "typescript",
+    "automation",
+    "enterprise",
+    "analytics"
   ],
   "files": [
-    "airtable_simple.js",
-    "airtable_simple_production.js",
+    "dist/",
+    "types/",
+    "bin/",
     "README.md",
     "LICENSE",
     "package.json",
-    "examples/",
-    "bin/"
+    "tsconfig.json"
   ],
+  "types": "types/typescript/index.d.ts",
   "author": "Rashid Azarang",
   "license": "MIT",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "1.19.1",
     "@smithery/cli": "^1.0.0",
-    "airtable": "^0.12.2",
-    "dotenv": "^16.0.0"
+    "dotenv": "^16.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/dotenv": "^8.2.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.50.0",
+    "eslint-config-prettier": "^9.0.0",
+    "jest": "^29.7.0",
+    "nodemon": "^3.0.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.3.0"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=18.0.0"
   },
   "repository": {
     "type": "git",

package/tsconfig.json

@@ -0,0 +1,44 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationDir": "./types",
+    "sourceMap": true,
+    "removeComments": false,
+    "noImplicitAny": true,
+    "noImplicitReturns": true,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "exactOptionalPropertyTypes": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": false,
+    "noUncheckedIndexedAccess": true,
+    "types": []
+  },
+  "include": [
+    "src/typescript/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "types",
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "src/javascript/**/*",
+    "src/python/**/*",
+    "src/typescript/prompt-templates.ts",
+    "src/typescript/tools-schemas.ts",
+    "src/typescript/**/*.d.ts"
+  ]
+}

package/types/typescript/airtable-mcp-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function start(): Promise<void>;

package/types/typescript/app/airtable-client.d.ts

@@ -0,0 +1,49 @@
+import { RateLimiter } from './rateLimiter';
+import { Logger } from './logger';
+interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /**
+     * Path including leading slash and version segment, e.g. `/v0/meta/bases/app123`.
+     */
+    path: string;
+    query?: Record<string, string | number | boolean | Array<string | number | boolean> | undefined>;
+    body?: unknown;
+    baseId?: string;
+    idempotencyKey?: string;
+}
+interface ClientOptions {
+    baseLimiter: RateLimiter;
+    patLimiter: RateLimiter;
+    logger: Logger;
+    userAgent: string;
+    patHash: string;
+    maxRetries?: number;
+}
+export declare class AirtableClient {
+    private readonly baseLimiter;
+    private readonly patLimiter;
+    private readonly logger;
+    private readonly userAgent;
+    private readonly pat;
+    private readonly patHash;
+    private readonly maxRetries;
+    constructor(personalAccessToken: string, options: ClientOptions);
+    listBases(): Promise<{
+        bases: unknown[];
+    }>;
+    getBase(baseId: string): Promise<unknown>;
+    listTables(baseId: string): Promise<{
+        tables: unknown[];
+    }>;
+    queryRecords<T = unknown>(baseId: string, table: string, query?: RequestOptions['query']): Promise<T>;
+    createRecords<T = unknown>(baseId: string, table: string, payload: unknown, idempotencyKey?: string): Promise<T>;
+    updateRecords<T = unknown>(baseId: string, table: string, payload: unknown, idempotencyKey?: string): Promise<T>;
+    upsertRecords<T = unknown>(baseId: string, table: string, payload: unknown, idempotencyKey?: string): Promise<T>;
+    private request;
+    private withRetry;
+    private backoffWithJitter;
+    private performRequest;
+    private toDomainError;
+    private safeExtractErrorType;
+}
+export {};

package/types/typescript/app/config.d.ts

@@ -0,0 +1,16 @@
+import { GovernanceSnapshot } from './types';
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+export interface AirtableAuthConfig {
+    personalAccessToken: string;
+    patHash: string;
+    defaultBaseId?: string;
+    allowedBases: string[];
+}
+export interface AppConfig {
+    version: string;
+    auth: AirtableAuthConfig;
+    governance: GovernanceSnapshot;
+    logLevel: LogLevel;
+    exceptionQueueSize: number;
+}
+export declare function loadConfig(): AppConfig;

package/types/typescript/app/context.d.ts

@@ -0,0 +1,12 @@
+import { AppConfig } from './config';
+import { AirtableClient } from './airtable-client';
+import { GovernanceService } from './governance';
+import { ExceptionStore } from './exceptions';
+import { Logger } from './logger';
+export interface AppContext {
+    config: AppConfig;
+    logger: Logger;
+    airtable: AirtableClient;
+    governance: GovernanceService;
+    exceptions: ExceptionStore;
+}

package/types/typescript/app/exceptions.d.ts

@@ -0,0 +1,12 @@
+import { Logger } from './logger';
+import { ListExceptionsInput, ListExceptionsOutput } from './types';
+import { AirtableBrainError } from '../errors';
+export declare class ExceptionStore {
+    private readonly capacity;
+    private readonly items;
+    private readonly logger;
+    constructor(capacity: number, logger: Logger);
+    record(error: AirtableBrainError, summary: string, details?: string, proposedFix?: Record<string, unknown>): void;
+    list(params: ListExceptionsInput): ListExceptionsOutput;
+    private parseCursor;
+}

package/types/typescript/app/governance.d.ts

@@ -0,0 +1,18 @@
+import { GovernanceSnapshot } from './types';
+type Operation = GovernanceSnapshot['allowedOperations'][number];
+export declare class GovernanceService {
+    private readonly snapshot;
+    private readonly tablesByBase;
+    constructor(snapshot: GovernanceSnapshot);
+    ensureBaseAllowed(baseId: string): void;
+    ensureOperationAllowed(operation: Operation): void;
+    ensureTableAllowed(baseId: string, table: string): void;
+    listPiiPolicies(baseId: string, table: string): Array<{
+        field: string;
+        policy: string;
+    }>;
+    getSnapshot(): GovernanceSnapshot;
+    isTableAllowed(baseId: string, table: string): boolean;
+    private buildTableIndex;
+}
+export {};

package/types/typescript/app/logger.d.ts

@@ -0,0 +1,13 @@
+import { LogLevel } from './config';
+export type LogMetadata = Record<string, unknown>;
+export declare class Logger {
+    private readonly level;
+    private readonly context;
+    constructor(level: LogLevel, context?: LogMetadata);
+    child(context: LogMetadata): Logger;
+    error(message: string, metadata?: LogMetadata): void;
+    warn(message: string, metadata?: LogMetadata): void;
+    info(message: string, metadata?: LogMetadata): void;
+    debug(message: string, metadata?: LogMetadata): void;
+    private log;
+}

package/types/typescript/app/rateLimiter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Lightweight token-based rate limiter to enforce Airtable quotas.
+ * Maintains per-key queues to preserve ordering and fairness.
+ */
+export declare class RateLimiter {
+    private readonly minIntervalMs;
+    private readonly lockByKey;
+    private readonly nextAvailableByKey;
+    constructor({ maxRequestsPerSecond }: {
+        maxRequestsPerSecond: number;
+    });
+    schedule(key: string): Promise<void>;
+}

package/types/typescript/app/tools/create.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerCreateTool(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/describe.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerDescribeTool(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/handleError.d.ts

@@ -0,0 +1,8 @@
+import { AppContext } from '../context';
+export declare function handleToolError(toolName: string, error: unknown, ctx: AppContext): {
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/types/typescript/app/tools/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerAllTools(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/listBases.d.ts

@@ -0,0 +1,33 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+import { z } from 'zod';
+declare const listBasesOutputSchema: z.ZodObject<{
+    bases: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        permissionLevel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        permissionLevel?: string | undefined;
+    }, {
+        id: string;
+        name: string;
+        permissionLevel?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    bases: {
+        id: string;
+        name: string;
+        permissionLevel?: string | undefined;
+    }[];
+}, {
+    bases: {
+        id: string;
+        name: string;
+        permissionLevel?: string | undefined;
+    }[];
+}>;
+export type ListBasesOutput = z.infer<typeof listBasesOutputSchema>;
+export declare function registerListBasesTool(server: McpServer, ctx: AppContext): void;
+export {};

package/types/typescript/app/tools/listExceptions.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerExceptionsTool(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/listGovernance.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerGovernanceTool(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/query.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerQueryTool(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/update.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerUpdateTool(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/upsert.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerUpsertTool(server: McpServer, ctx: AppContext): void;

package/types/typescript/app/tools/webhooks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import { AppContext } from '../context';
+export declare function registerWebhookTools(server: McpServer, ctx: AppContext): void;