attio-mcp 0.1.1 → 1.0.0

package/dist/server/createServer.js

@@ -0,0 +1,74 @@
+/**
+ * Factory function to create and configure an MCP server instance
+ * This centralizes all server setup logic to be reused by different transports
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { createScopedLogger } from '../utils/logger.js';
+import { z } from 'zod';
+import { registerResourceHandlers } from '../handlers/resources.js';
+import { registerToolHandlers } from '../handlers/tools/index.js';
+import { registerPromptHandlers } from '../prompts/handlers.js';
+import { setGlobalContext } from '../api/lazy-client.js';
+/**
+ * Configuration schema for Smithery/Playground auto-discovery
+ * This allows scanners to build a test configuration without guessing.
+ */
+export const configSchema = z.object({
+    ATTIO_API_KEY: z.string().min(1).optional().describe('Attio API key'),
+    ATTIO_WORKSPACE_ID: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Attio workspace ID'),
+    ALLOWED_ORIGINS: z
+        .string()
+        .optional()
+        .describe('Comma-separated CORS origins'),
+    debug: z.boolean().default(false).describe('Enable verbose logging'),
+});
+/**
+ * Creates an MCP server instance
+ *
+ * @param context - Optional context for configuration (used by Smithery)
+ * @returns Configured MCP server instance
+ */
+export function createServer(context) {
+    const startTime = Date.now();
+    createScopedLogger('mcp.init', 'createServer').info('Server creation started');
+    // For backward compatibility: if no context provided (STDIO mode),
+    // create one that reads from environment variables
+    const ctx = context || {
+        getApiKey: () => process.env.ATTIO_API_KEY,
+        getWorkspaceId: () => process.env.ATTIO_WORKSPACE_ID,
+    };
+    // Set the global context so lazy client can access it
+    setGlobalContext(ctx);
+    createScopedLogger('mcp.init', 'createServer').info('Global context set');
+    // Create MCP server with proper capabilities declaration
+    // Note: No API key validation here - it's checked when tools are invoked
+    const mcpServer = new Server({
+        name: 'attio-mcp-server',
+        version: '0.2.0',
+    }, {
+        capabilities: {
+            resources: {},
+            tools: {},
+            prompts: {
+                list: {},
+                get: {},
+            },
+        },
+    });
+    // Register all handlers with the context
+    // The handlers will use the context to get API key when needed
+    createScopedLogger('mcp.init', 'createServer').info('Registering handlers');
+    registerResourceHandlers(mcpServer, ctx);
+    registerToolHandlers(mcpServer, ctx);
+    registerPromptHandlers(mcpServer, ctx);
+    const duration = Date.now() - startTime;
+    createScopedLogger('mcp.init', 'createServer').info('Server created', {
+        durationMs: duration,
+    });
+    return mcpServer;
+}
+//# sourceMappingURL=createServer.js.map

package/dist/server/createServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createServer.js","sourceRoot":"","sources":["../../src/server/createServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAWzD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IACrE,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,oBAAoB,CAAC;IACjC,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8BAA8B,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CACrE,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAuB;IAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,kBAAkB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,IAAI,CACjD,yBAAyB,CAC1B,CAAC;IAEF,mEAAmE;IACnE,mDAAmD;IACnD,MAAM,GAAG,GAAkB,OAAO,IAAI;QACpC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa;QAC1C,cAAc,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB;KACrD,CAAC;IAEF,sDAAsD;IACtD,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,kBAAkB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAE1E,yDAAyD;IACzD,yEAAyE;IACzE,MAAM,SAAS,GAAG,IAAI,MAAM,CAC1B;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,EAAE;gBACR,GAAG,EAAE,EAAE;aACR;SACF;KACF,CACF,CAAC;IAEF,yCAAyC;IACzC,+DAA+D;IAC/D,kBAAkB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC5E,wBAAwB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACzC,oBAAoB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,sBAAsB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,kBAAkB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE;QACpE,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/services/CachingService.d.ts

@@ -0,0 +1,201 @@
+/**
+ * CachingService - Centralized caching utilities for universal handlers
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 2.
+ * Provides task caching, 404 response caching, and attribute discovery caching
+ * functionality with configurable TTLs and automatic cleanup.
+ */
+import { AttioRecord } from '../types/attio.js';
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+/**
+ * Cache statistics for monitoring and debugging
+ */
+interface CacheStats {
+    tasks: {
+        hits: number;
+        misses: number;
+        entries: number;
+    };
+    attributes: {
+        hits: number;
+        misses: number;
+        entries: number;
+    };
+    notFound: {
+        hits: number;
+        misses: number;
+        entries: number;
+    };
+}
+/**
+ * CachingService provides centralized caching functionality for universal handlers
+ */
+export declare class CachingService {
+    private static tasksCache;
+    private static attributesCache;
+    private static notFoundCache;
+    private static stats;
+    /**
+     * Get cached tasks with automatic TTL management
+     *
+     * @param cacheKey - Cache key for the tasks
+     * @param ttl - Time to live in milliseconds (default: 30 seconds)
+     * @returns Cached tasks if available and valid, undefined otherwise
+     */
+    static getCachedTasks(cacheKey: string, ttl?: number): AttioRecord[] | undefined;
+    /**
+     * Cache tasks data with timestamp
+     *
+     * @param cacheKey - Cache key for the tasks
+     * @param data - Tasks data to cache
+     */
+    static setCachedTasks(cacheKey: string, data: AttioRecord[]): void;
+    /**
+     * Generate cache key for tasks list
+     *
+     * @returns Standard cache key for tasks list
+     */
+    static getTasksListCacheKey(): string;
+    /**
+     * Check if a 404 response is cached for a given resource
+     *
+     * @param resourceType - Type of resource (e.g., 'companies', 'people')
+     * @param recordId - ID of the record
+     * @returns True if 404 is cached, false otherwise
+     */
+    static isCached404(resourceType: string, recordId: string): boolean;
+    /**
+     * Cache a 404 response for a resource
+     *
+     * @param resourceType - Type of resource (e.g., 'companies', 'people')
+     * @param recordId - ID of the record
+     * @param ttl - Time to live in milliseconds (default: 60 seconds)
+     */
+    static cache404Response(resourceType: string, recordId: string, ttl?: number): void;
+    /**
+     * Generate cache key for attribute discovery
+     *
+     * @param resourceType - The resource type
+     * @param objectSlug - Optional object slug for records
+     * @returns Cache key string
+     */
+    private static getAttributeCacheKey;
+    /**
+     * Get cached attribute discovery results
+     *
+     * @param resourceType - The resource type
+     * @param objectSlug - Optional object slug for records
+     * @param ttl - Time to live in milliseconds
+     * @returns Cached attributes if available and valid, undefined otherwise
+     */
+    static getCachedAttributes(resourceType: UniversalResourceType, objectSlug?: string, ttl?: number): Record<string, unknown> | undefined;
+    /**
+     * Cache attribute discovery results
+     *
+     * @param resourceType - The resource type
+     * @param data - Attribute discovery results to cache
+     * @param objectSlug - Optional object slug for records
+     */
+    static setCachedAttributes(resourceType: UniversalResourceType, data: Record<string, unknown>, objectSlug?: string): void;
+    /**
+     * Invalidate attribute cache for a specific resource type
+     *
+     * @param resourceType - The resource type to invalidate
+     * @param objectSlug - Optional object slug to invalidate specific records cache
+     */
+    static invalidateAttributeCache(resourceType: UniversalResourceType, objectSlug?: string): void;
+    /**
+     * Manage attribute caching with automatic data loading
+     *
+     * @param dataLoader - Function to load attribute data when cache miss occurs
+     * @param resourceType - The resource type
+     * @param objectSlug - Optional object slug for records
+     * @param ttl - Time to live in milliseconds
+     * @returns Cached or freshly loaded attribute data
+     */
+    static getOrLoadAttributes(dataLoader: () => Promise<Record<string, unknown>>, resourceType: UniversalResourceType, objectSlug?: string, ttl?: number): Promise<{
+        data: Record<string, unknown>;
+        fromCache: boolean;
+    }>;
+    /**
+     * Clear all tasks cache entries
+     */
+    static clearTasksCache(): void;
+    /**
+     * Clear all attributes cache entries
+     */
+    static clearAttributesCache(): void;
+    /**
+     * Clear all 404 cache entries
+     */
+    static clearNotFoundCache(): void;
+    /**
+     * Clear all cache entries
+     */
+    static clearAllCache(): void;
+    /**
+     * Clear expired cache entries for all cache types
+     */
+    static clearExpiredCache(): void;
+    /**
+     * Clear expired tasks cache entries
+     *
+     * @param ttl - Time to live in milliseconds
+     */
+    static clearExpiredTasksCache(ttl?: number): void;
+    /**
+     * Clear expired attributes cache entries
+     *
+     * @param ttl - Time to live in milliseconds
+     */
+    static clearExpiredAttributesCache(ttl?: number): void;
+    /**
+     * Clear expired 404 cache entries
+     *
+     * @param ttl - Time to live in milliseconds
+     */
+    static clearExpiredNotFoundCache(ttl?: number): void;
+    /**
+     * Perform automatic cache cleanup when cache size exceeds limits
+     */
+    private static performCacheCleanup;
+    /**
+     * Clear oldest cache entries to maintain cache size limits
+     */
+    private static clearOldestEntries;
+    /**
+     * Get comprehensive cache statistics for monitoring
+     *
+     * @returns Detailed cache statistics
+     */
+    static getCacheStats(): CacheStats & {
+        totalEntries: number;
+        tasksCacheSize: number;
+        tasksCacheEntries: string[];
+        cacheEfficiency: {
+            tasks: number;
+            attributes: number;
+            notFound: number;
+            overall: number;
+        };
+    };
+    /**
+     * Manage task caching with automatic data loading
+     *
+     * This method encapsulates the common pattern of:
+     * 1. Check cache for valid data
+     * 2. Load data if cache miss
+     * 3. Cache the loaded data
+     *
+     * @param dataLoader - Function to load data when cache miss occurs
+     * @param cacheKey - Cache key (default: standard tasks list key)
+     * @param ttl - Time to live in milliseconds
+     * @returns Cached or freshly loaded data
+     */
+    static getOrLoadTasks(dataLoader: () => Promise<AttioRecord[]>, cacheKey?: string, ttl?: number): Promise<{
+        data: AttioRecord[];
+        fromCache: boolean;
+    }>;
+}
+export {};
+//# sourceMappingURL=CachingService.d.ts.map

package/dist/services/CachingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CachingService.d.ts","sourceRoot":"","sources":["../../src/services/CachingService.ts"],"names":[],"mappings":"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"}