@mcp-z/mcp-sheets 1.0.0

package/dist/esm/spreadsheet/spreadsheet-management.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/spreadsheet/spreadsheet-management.ts"],"sourcesContent":["import type { drive_v3, sheets_v4 } from 'googleapis';\nimport type { GoogleApiError } from '../types.js';\n\nexport const SPREADSHEET_URL_RE = /https:\\/\\/docs.google.com\\/spreadsheets\\/d\\/([a-zA-Z0-9-_]{10,})/;\nexport const SPREADSHEET_ID_RE = /^[a-zA-Z0-9-_]{30,}$/;\n\nexport async function findById(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, id: string) {\n  const ssResp = await sheets.spreadsheets.get({ spreadsheetId: id }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dmResp = await drive.files.get({ fileId: id, fields: 'modifiedTime,webViewLink,name' }).catch((e: unknown) => {\n    const error = e as GoogleApiError;\n    const status = error?.response?.status || error?.status || error?.code;\n    if (Number(status) === 404) return null;\n    throw e;\n  });\n  const dm = dmResp?.data;\n  if (!ssResp) return null;\n  const ss = ssResp.data;\n  return {\n    id: id,\n    spreadsheetTitle: ss?.properties?.title ?? dm?.name,\n    url: ss?.spreadsheetUrl ?? dm?.webViewLink,\n    modifiedTime: dm?.modifiedTime,\n  };\n}\n\nexport async function findByName(drive: drive_v3.Drive, name: string) {\n  const escaped = String(name).replace(/['\"\\\\]/g, (m) => `\\\\${m}`);\n  const q = `mimeType='application/vnd.google-apps.spreadsheet' and name contains '${escaped}' and trashed = false`;\n  const resp = await drive.files.list({ q, pageSize: 50, fields: 'files(id,name,webViewLink,modifiedTime)' });\n  const files = resp.data?.files || [];\n  return files.map((f) => ({ id: String(f.id), spreadsheetTitle: String(f.name), url: String(f.webViewLink), modifiedTime: f.modifiedTime }));\n}\n\nexport async function findSpreadsheetsByRef(sheets: sheets_v4.Sheets, drive: drive_v3.Drive, ref: string) {\n  const trimmedRef = ref?.trim();\n  if (!trimmedRef) return [];\n\n  // Strategy 1: Try URL extraction (most specific)\n  const urlMatch = trimmedRef.match(SPREADSHEET_URL_RE);\n  if (urlMatch && typeof urlMatch[1] === 'string' && urlMatch[1].length > 0) {\n    const id = urlMatch[1];\n    const r = await findById(sheets, drive, id);\n    return r ? [r] : [];\n  }\n\n  // Strategy 2: Try direct ID match (if it looks like a spreadsheet ID)\n  if (SPREADSHEET_ID_RE.test(trimmedRef)) {\n    const r = await findById(sheets, drive, trimmedRef);\n    return r ? [r] : [];\n  }\n\n  // Strategy 3: Search by name\n  return await findByName(drive, trimmedRef);\n}\n"],"names":["SPREADSHEET_URL_RE","SPREADSHEET_ID_RE","findById","sheets","drive","id","ss","ssResp","spreadsheets","get","spreadsheetId","catch","e","error","status","response","code","Number","dmResp","files","fileId","fields","dm","data","spreadsheetTitle","properties","title","name","url","spreadsheetUrl","webViewLink","modifiedTime","findByName","resp","escaped","String","replace","m","q","list","pageSize","map","f","findSpreadsheetsByRef","ref","trimmedRef","trim","urlMatch","match","length","r","test"],"mappings":"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"}

package/dist/esm/types.d.ts

@@ -0,0 +1,53 @@
+import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';
+import type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';
+import type { Keyv } from 'keyv';
+import type { OAuthAdapters } from './setup/oauth-google.js';
+export type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;
+/**
+ * Composes transport config, OAuth config, and application-level config
+ */
+export interface ServerConfig extends BaseServerConfig, OAuthConfig {
+    logLevel: string;
+    baseDir: string;
+    name: string;
+    version: string;
+    repositoryUrl: string;
+    baseUrl?: string;
+    dcrConfig?: DcrConfig;
+}
+export interface GoogleApiError {
+    response?: {
+        status?: number;
+    };
+    status?: number;
+    statusCode?: number;
+    code?: number | string;
+    message?: string;
+}
+/** Runtime dependencies exposed to middleware/factories. */
+export interface RuntimeDeps {
+    config: ServerConfig;
+    logger: ServerLogger;
+    tokenStore: Keyv<CachedToken>;
+    oauthAdapters: OAuthAdapters;
+    baseUrl?: string;
+}
+/** Collections of MCP modules produced by domain factories. */
+export type DomainModules = {
+    tools: ToolModule[];
+    resources: ResourceModule[];
+    prompts: PromptModule[];
+};
+/** Factory that produces a middleware layer given runtime dependencies. */
+export type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;
+/** Shared runtime configuration returned by `createDefaultRuntime`. */
+export interface CommonRuntime {
+    deps: RuntimeDeps;
+    middlewareFactories: MiddlewareFactory[];
+    createDomainModules: () => DomainModules;
+    close: () => Promise<void>;
+}
+export interface RuntimeOverrides {
+    middlewareFactories?: MiddlewareFactory[];
+    createDomainModules?: () => DomainModules;
+}

package/dist/esm/types.js

@@ -0,0 +1 @@
+export { };

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-sheets/src/types.ts"],"sourcesContent":["import type { CachedToken, DcrConfig, OAuthConfig } from '@mcp-z/oauth-google';\nimport type { BaseServerConfig, MiddlewareLayer, PromptModule, ResourceModule, Logger as ServerLogger, ToolModule } from '@mcp-z/server';\nimport type { Keyv } from 'keyv';\nimport type { OAuthAdapters } from './setup/oauth-google.js';\n\nexport type Logger = Pick<Console, 'info' | 'error' | 'warn' | 'debug'>;\n\n/**\n * Composes transport config, OAuth config, and application-level config\n */\nexport interface ServerConfig extends BaseServerConfig, OAuthConfig {\n  logLevel: string;\n  baseDir: string;\n  name: string;\n  version: string;\n  repositoryUrl: string;\n  baseUrl?: string;\n\n  // DCR configuration (when auth === 'dcr')\n  dcrConfig?: DcrConfig;\n}\n\nexport interface GoogleApiError {\n  response?: { status?: number };\n  status?: number;\n  statusCode?: number;\n  code?: number | string;\n  message?: string;\n}\n\n/** Runtime dependencies exposed to middleware/factories. */\nexport interface RuntimeDeps {\n  config: ServerConfig;\n  logger: ServerLogger;\n  tokenStore: Keyv<CachedToken>;\n  oauthAdapters: OAuthAdapters;\n  baseUrl?: string;\n}\n\n/** Collections of MCP modules produced by domain factories. */\nexport type DomainModules = {\n  tools: ToolModule[];\n  resources: ResourceModule[];\n  prompts: PromptModule[];\n};\n\n/** Factory that produces a middleware layer given runtime dependencies. */\nexport type MiddlewareFactory = (deps: RuntimeDeps) => MiddlewareLayer;\n\n/** Shared runtime configuration returned by `createDefaultRuntime`. */\nexport interface CommonRuntime {\n  deps: RuntimeDeps;\n  middlewareFactories: MiddlewareFactory[];\n  createDomainModules: () => DomainModules;\n  close: () => Promise<void>;\n}\n\nexport interface RuntimeOverrides {\n  middlewareFactories?: MiddlewareFactory[];\n  createDomainModules?: () => DomainModules;\n}\n"],"names":[],"mappings":"AAyDA,WAGC"}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@mcp-z/mcp-sheets",
+  "version": "1.0.0",
+  "description": "MCP server for Google Sheets integration with OAuth authentication, spreadsheet management, batch operations, and advanced formatting",
+  "keywords": [
+    "sheets",
+    "google sheets",
+    "google",
+    "spreadsheet",
+    "mcp",
+    "ai",
+    "mcp-server",
+    "model context protocol",
+    "oauth",
+    "google api",
+    "spreadsheet automation",
+    "data management",
+    "batch operations",
+    "ai agent",
+    "claude",
+    "llm",
+    "charts",
+    "formatting",
+    "cell validation",
+    "data export",
+    "productivity",
+    "automation",
+    "typescript",
+    "nodejs",
+    "integration",
+    "api client"
+  ],
+  "homepage": "https://github.com/mcp-z/mcp-sheets#readme",
+  "bugs": {
+    "url": "https://github.com/mcp-z/mcp-sheets/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcp-z/mcp-sheets.git"
+  },
+  "license": "MIT",
+  "author": "Kevin Malakoff <kmalakoff.info@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "bin": "bin/server.js",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc -p . --noEmit && tsds build",
+    "format": "tsds format",
+    "prepublish:check": "ncp",
+    "prepublishOnly": "tsds validate",
+    "test": "npm run test:unit && npm run test:integration",
+    "test:engines": "nvu engines tsds test:node --no-timeouts 'test/**/*.test.ts'",
+    "test:integration": "tsds test:node --no-timeouts 'test/integration/**/*.test.ts'",
+    "test:setup": "node scripts/setup-test.ts",
+    "test:unit": "tsds test:node --no-timeouts 'test/unit/**/*.test.ts'",
+    "version": "tsds version"
+  },
+  "dependencies": {
+    "@mcp-z/oauth": "^1.0.0",
+    "@mcp-z/oauth-google": "^1.0.0",
+    "@mcp-z/server": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "cors": "^2.0.0",
+    "csv-parse": "^6.1.0",
+    "express": "^5.0.0",
+    "google-auth-library": "^10.0.0",
+    "googleapis": "^169.0.0",
+    "keyv-registry": "^0.3.0",
+    "module-root-sync": "^2.0.0",
+    "pino": "^10.0.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@mcp-z/client": "^1.0.0",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^25.0.2",
+    "dotenv": "^17.2.3",
+    "get-port": "^7.1.0",
+    "keyv": "^5.5.5",
+    "node-version-use": "^2.1.6",
+    "ts-dev-stack": "^1.21.3",
+    "tsds-config": "^1.0.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "mcpName": "io.github.mcp-z/mcp-sheets",
+  "tsds": {
+    "source": "src/index.ts"
+  }
+}