@reveldigital/mcp-graphql-proxy 1.0.0

package/dist/index.js

@@ -0,0 +1,377 @@
+#!/usr/bin/env node
+/**
+ * Revel Digital MCP GraphQL Proxy Server
+ *
+ * An MCP server that enables AI agents to interact with the Revel Digital
+ * GraphQL API for digital signage management.
+ *
+ * Features:
+ * - Execute custom GraphQL queries
+ * - Build optimized queries with field selection
+ * - Authentication header proxying
+ * - Response caching
+ * - Context window optimization
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { GraphQLClient } from './core/graphql-client.js';
+import { ResponseCache } from './core/cache.js';
+import { QueryBuilder } from './core/query-builder.js';
+import { ResponseOptimizer } from './core/response-optimizer.js';
+import { defaultGraphQLProxyConfig, } from './types/graphql-proxy.js';
+// ============================================================================
+// Server Configuration
+// ============================================================================
+const config = {
+    ...defaultGraphQLProxyConfig,
+    endpoint: process.env.REVELDIGITAL_GRAPHQL_ENDPOINT ?? defaultGraphQLProxyConfig.endpoint,
+    // REVELDIGITAL_AUTH_TOKEN → Authorization: Bearer header
+    authToken: process.env.REVELDIGITAL_AUTH_TOKEN,
+    timeout: parseInt(process.env.REQUEST_TIMEOUT ?? '30000', 10),
+    enableCache: process.env.ENABLE_CACHE !== 'false',
+    cacheTtl: parseInt(process.env.CACHE_TTL ?? '300', 10),
+    maxResponseSize: parseInt(process.env.MAX_RESPONSE_SIZE ?? '50000', 10),
+    debug: process.env.DEBUG === 'true',
+};
+// ============================================================================
+// Initialize Components
+// ============================================================================
+const graphqlClient = new GraphQLClient(config);
+const cache = new ResponseCache(config.cacheTtl);
+const optimizer = new ResponseOptimizer(config.maxResponseSize);
+// ============================================================================
+// MCP Server Setup
+// ============================================================================
+const server = new McpServer({
+    name: 'reveldigital-graphql-proxy',
+    version: '1.0.0',
+});
+// ============================================================================
+// Tool: Execute GraphQL Query
+// ============================================================================
+server.tool('execute_query', 'Execute a GraphQL query against the Revel Digital API. Supports custom queries with variables.', {
+    query: z.string().describe('The GraphQL query string to execute'),
+    variables: z.record(z.unknown()).optional().describe('Query variables as a JSON object'),
+    operationName: z.string().optional().describe('Operation name if query contains multiple operations'),
+    useCache: z.boolean().optional().default(true).describe('Whether to use cached results if available'),
+}, async (args) => {
+    const startTime = Date.now();
+    try {
+        // Check cache first
+        if (args.useCache && config.enableCache) {
+            const cached = cache.get(args.query, args.variables);
+            if (cached) {
+                const result = {
+                    success: true,
+                    data: cached,
+                    metadata: {
+                        queryTime: Date.now() - startTime,
+                        cached: true,
+                    },
+                };
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+        }
+        // Execute query
+        const response = await graphqlClient.query(args.query, args.variables, args.operationName);
+        // Handle errors
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+                data: response.data,
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        // Cache successful response
+        if (args.useCache && config.enableCache && response.data) {
+            cache.set(args.query, args.variables, response.data);
+        }
+        // Optimize response for context window
+        const optimized = optimizer.optimize(response.data);
+        const result = {
+            success: true,
+            data: optimized.data,
+            metadata: {
+                queryTime: Date.now() - startTime,
+                cached: false,
+                ...optimized.metadata,
+            },
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Build Optimized Query
+// ============================================================================
+server.tool('build_query', 'Build an optimized GraphQL query with field selection, filtering, and sorting. Returns query and variables ready for execution.', {
+    operation: z.enum([
+        'device', 'deviceGroups', 'media', 'mediaGroups',
+        'playlist', 'playlistGroups', 'schedule', 'scheduleGroups',
+        'template', 'templateGroups', 'user',
+        'playLogs', 'pingLogs', 'eventLogs', 'impressions',
+        'deviceMetrics', 'audienceMetrics', 'mediaPlayStats',
+    ]).describe('The query operation to perform'),
+    fields: z.array(z.string()).describe('Fields to select. Use dot notation for nested fields (e.g., "pingData.cpuUsage")'),
+    preset: z.enum(['minimal', 'basic', 'status', 'location', 'full']).optional()
+        .describe('Use a predefined field set instead of specifying fields'),
+    filter: z.record(z.unknown()).optional().describe('Filter conditions (e.g., {"isOnline": true})'),
+    limit: z.number().optional().describe('Maximum number of results to return'),
+    orderBy: z.string().optional().describe('Field to sort by'),
+    orderDirection: z.enum(['ASC', 'DESC']).optional().default('ASC').describe('Sort direction'),
+    startDate: z.string().optional().describe('Start date for analytics queries (ISO 8601 format)'),
+    endDate: z.string().optional().describe('End date for analytics queries (ISO 8601 format)'),
+    deviceId: z.array(z.string()).optional().describe('Filter by device IDs (for analytics)'),
+}, async (args) => {
+    try {
+        const queryArgs = {};
+        // Add date range for analytics queries
+        if (args.startDate)
+            queryArgs.startDate = args.startDate;
+        if (args.endDate)
+            queryArgs.endDate = args.endDate;
+        if (args.deviceId)
+            queryArgs.deviceId = args.deviceId;
+        if (args.limit)
+            queryArgs.limit = args.limit;
+        const { query, variables } = QueryBuilder.build({
+            operation: args.operation,
+            fields: args.fields ?? [],
+            preset: args.preset,
+            arguments: queryArgs,
+            filter: args.filter,
+            orderBy: args.orderBy ? { field: args.orderBy, direction: args.orderDirection ?? 'ASC' } : undefined,
+        });
+        const result = {
+            success: true,
+            query,
+            variables,
+            tip: 'Use execute_query tool with this query and variables to run it.',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Introspect Schema
+// ============================================================================
+server.tool('introspect_schema', 'Get information about the Revel Digital GraphQL schema. Use this to discover available types, fields, and query parameters.', {
+    typeName: z.string().optional().describe('Specific type name to introspect (e.g., "Device", "Media"). If not provided, returns overview.'),
+}, async (args) => {
+    try {
+        let response;
+        if (args.typeName) {
+            response = await graphqlClient.introspectType(args.typeName);
+        }
+        else {
+            // Return a summary of available queries instead of full introspection
+            const operations = QueryBuilder.getOperations();
+            const result = {
+                success: true,
+                data: {
+                    availableQueries: operations,
+                    contentManagement: ['device', 'deviceGroups', 'media', 'mediaGroups', 'playlist', 'playlistGroups', 'schedule', 'scheduleGroups', 'template', 'templateGroups', 'user'],
+                    analytics: ['playLogs', 'pingLogs', 'eventLogs', 'impressions', 'deviceMetrics', 'audienceMetrics', 'mediaPlayStats'],
+                    fieldPresets: {
+                        device: Object.keys(QueryBuilder.getFieldPresets('device') ?? {}),
+                        media: Object.keys(QueryBuilder.getFieldPresets('media') ?? {}),
+                        playlist: Object.keys(QueryBuilder.getFieldPresets('playlist') ?? {}),
+                        schedule: Object.keys(QueryBuilder.getFieldPresets('schedule') ?? {}),
+                    },
+                    tip: 'Use introspect_schema with typeName parameter to get details about specific types.',
+                },
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        // Optimize introspection response
+        const optimized = optimizer.optimize(response.data, { maxSize: 30000 });
+        const result = {
+            success: true,
+            data: optimized.data,
+            metadata: optimized.metadata,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Quick Queries
+// ============================================================================
+server.tool('quick_query', 'Execute common pre-built queries for typical use cases.', {
+    queryType: z.enum([
+        'devices_status',
+        'online_devices',
+        'recent_media',
+        'active_schedules',
+        'play_logs',
+    ]).describe('Type of quick query to execute'),
+    startDate: z.string().optional().describe('Start date for analytics (required for play_logs)'),
+    endDate: z.string().optional().describe('End date for analytics (required for play_logs)'),
+    deviceId: z.array(z.string()).optional().describe('Device IDs to filter by (for play_logs)'),
+    limit: z.number().optional().default(50).describe('Maximum results to return'),
+}, async (args) => {
+    try {
+        let queryConfig;
+        switch (args.queryType) {
+            case 'devices_status':
+                queryConfig = QueryBuilder.quick.devicesStatus();
+                break;
+            case 'online_devices':
+                queryConfig = QueryBuilder.quick.onlineDevices();
+                break;
+            case 'recent_media':
+                queryConfig = QueryBuilder.quick.recentMedia(args.limit);
+                break;
+            case 'active_schedules':
+                queryConfig = QueryBuilder.quick.activeSchedules();
+                break;
+            case 'play_logs':
+                if (!args.startDate || !args.endDate) {
+                    throw new Error('play_logs requires startDate and endDate');
+                }
+                queryConfig = QueryBuilder.quick.playLogs(args.startDate, args.endDate, args.deviceId);
+                break;
+            default:
+                throw new Error(`Unknown query type: ${args.queryType}`);
+        }
+        const response = await graphqlClient.query(queryConfig.query, queryConfig.variables);
+        if (response.errors && response.errors.length > 0) {
+            const result = {
+                success: false,
+                error: response.errors.map((e) => e.message).join('; '),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        const optimized = optimizer.optimize(response.data);
+        const result = {
+            success: true,
+            data: optimized.data,
+            metadata: optimized.metadata,
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        const result = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+});
+// ============================================================================
+// Tool: Cache Management
+// ============================================================================
+server.tool('manage_cache', 'Manage the response cache - view statistics or clear cached data.', {
+    action: z.enum(['stats', 'clear', 'cleanup']).describe('Cache action to perform'),
+}, async (args) => {
+    switch (args.action) {
+        case 'stats': {
+            const stats = cache.getStats();
+            const hitRate = cache.getHitRate();
+            const result = {
+                success: true,
+                data: {
+                    ...stats,
+                    hitRate: `${(hitRate * 100).toFixed(1)}%`,
+                    sizeFormatted: ResponseOptimizer.formatSize(stats.size),
+                },
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'clear':
+            cache.clear();
+            return { content: [{ type: 'text', text: JSON.stringify({ success: true, message: 'Cache cleared' }, null, 2) }] };
+        case 'cleanup': {
+            const removed = cache.cleanup();
+            return { content: [{ type: 'text', text: JSON.stringify({ success: true, message: `Removed ${removed} expired entries` }, null, 2) }] };
+        }
+    }
+});
+// ============================================================================
+// Resources: Schema Documentation
+// ============================================================================
+server.resource('schema://reveldigital/graphql', 'Revel Digital GraphQL Schema', async () => {
+    const schemaContent = `# Revel Digital GraphQL API
+
+## Available Queries
+
+### Content Management
+- device - Query devices (players)
+- deviceGroups - Query device groups
+- media - Query media files
+- mediaGroups - Query media groups
+- playlist - Query playlists
+- playlistGroups - Query playlist groups
+- schedule - Query schedules
+- scheduleGroups - Query schedule groups
+- template - Query templates
+- templateGroups - Query template groups
+- user - Query users
+
+### Analytics (require date range)
+- playLogs - Content playback records
+- pingLogs - Device health/heartbeat logs
+- eventLogs - Custom event logs
+- impressions - Audience detection data
+- deviceMetrics - Aggregated device health
+- audienceMetrics - Aggregated audience data
+- mediaPlayStats - Media performance stats
+
+## Field Presets
+Use the build_query tool with preset parameter:
+- minimal - Just ID and name
+- basic - Common fields
+- status - Include health/status data
+- location - Include location data
+- full - All available fields
+
+## Authentication
+Set API key via environment variable REVELDIGITAL_API_KEY
+or use set_auth tool at runtime.
+`;
+    return {
+        contents: [{
+                uri: 'schema://reveldigital/graphql',
+                text: schemaContent,
+                mimeType: 'text/markdown'
+            }]
+    };
+});
+// ============================================================================
+// Start Server
+// ============================================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    if (config.debug) {
+        console.error('[MCP] Starting Revel Digital GraphQL Proxy Server');
+        console.error(`[MCP] Endpoint: ${config.endpoint}`);
+        console.error(`[MCP] Cache enabled: ${config.enableCache}`);
+        console.error(`[MCP] Auth Token (Bearer): ${config.authToken ? 'configured' : 'NOT SET - authentication required!'}`);
+    }
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('[MCP] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types/auth.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Authentication Types
+ *
+ * Authentication configuration and runtime context interfaces.
+ */
+/**
+ * Authentication configuration
+ */
+export interface AuthConfig {
+    /** Default authentication method */
+    defaultMethod: AuthMethod;
+    /** API key configurations (for multi-tenant) */
+    apiKeys: ApiKeyConfig[];
+    /** Header injection settings */
+    headerInjection: HeaderInjectionConfig;
+    /** Session management */
+    session: SessionConfig;
+}
+/**
+ * Supported authentication methods for Revel Digital API
+ */
+export type AuthMethod = 'bearer' | 'api-key-header' | 'query-param';
+/**
+ * API key configuration for a tenant or client
+ */
+export interface ApiKeyConfig {
+    /** Unique identifier for this API key configuration */
+    id: string;
+    /** Display name */
+    name: string;
+    /** The actual API key (or reference to secret store) */
+    key: string;
+    /** Associated tenant ID */
+    tenantId?: string;
+    /** Authentication method to use */
+    method: AuthMethod;
+    /** Custom header name for api-key-header method (default: X-RevelDigital-API) */
+    headerName?: string;
+    /** Query parameter name for query-param method (default: apiKey) */
+    queryParam?: string;
+    /** Scopes/permissions for this key */
+    scopes?: string[];
+    /** Expiration timestamp */
+    expiresAt?: Date;
+    /** Is this key active? */
+    active: boolean;
+    /** Key metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Header injection configuration
+ */
+export interface HeaderInjectionConfig {
+    /** Headers to inject on every request */
+    static: Record<string, string>;
+    /** Dynamic header generation rules */
+    dynamic: DynamicHeaderRule[];
+}
+/**
+ * Dynamic header generation rule
+ */
+export interface DynamicHeaderRule {
+    /** Header name to inject */
+    name: string;
+    /** Source of the value */
+    source: HeaderValueSource;
+    /** Source path or key */
+    path: string;
+    /** Transformation to apply */
+    transform?: string;
+    /** Condition for applying this header */
+    condition?: string;
+}
+/**
+ * Sources for dynamic header values
+ */
+export type HeaderValueSource = 'env' | 'config' | 'request' | 'computed' | 'context';
+/**
+ * Session management configuration
+ */
+export interface SessionConfig {
+    /** Enable session tracking */
+    enabled: boolean;
+    /** Session timeout in milliseconds */
+    timeoutMs: number;
+    /** Session storage type */
+    storage: 'memory' | 'redis';
+    /** Redis connection options if storage is 'redis' */
+    redisOptions?: RedisSessionOptions;
+}
+/**
+ * Redis session storage options
+ */
+export interface RedisSessionOptions {
+    /** Redis host */
+    host: string;
+    /** Redis port */
+    port: number;
+    /** Redis password */
+    password?: string;
+    /** Redis database number */
+    db?: number;
+    /** Key prefix for session data */
+    keyPrefix?: string;
+}
+/**
+ * Runtime authentication context resolved for a request
+ */
+export interface AuthContext {
+    /** Resolved tenant ID */
+    tenantId: string;
+    /** API key configuration used */
+    apiKeyConfig: ApiKeyConfig;
+    /** Session ID if sessions enabled */
+    sessionId?: string;
+    /** Scopes available in this context */
+    scopes: string[];
+    /** Timestamp of authentication */
+    authenticatedAt: Date;
+    /** Is the authentication valid? */
+    isValid: boolean;
+    /** Error message if not valid */
+    errorMessage?: string;
+}
+/**
+ * Authentication result from validation
+ */
+export interface AuthResult {
+    /** Was authentication successful? */
+    success: boolean;
+    /** Auth context if successful */
+    context?: AuthContext;
+    /** Error code if failed */
+    errorCode?: AuthErrorCode;
+    /** Error message if failed */
+    errorMessage?: string;
+}
+/**
+ * Authentication error codes
+ */
+export type AuthErrorCode = 'MISSING_CREDENTIALS' | 'INVALID_API_KEY' | 'EXPIRED_API_KEY' | 'INACTIVE_API_KEY' | 'INSUFFICIENT_SCOPE' | 'INVALID_SESSION' | 'SESSION_EXPIRED';
+/**
+ * Default authentication configuration
+ */
+export declare const DEFAULT_AUTH_CONFIG: AuthConfig;
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.map

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

package/dist/types/auth.js

@@ -0,0 +1,22 @@
+/**
+ * Authentication Types
+ *
+ * Authentication configuration and runtime context interfaces.
+ */
+/**
+ * Default authentication configuration
+ */
+export const DEFAULT_AUTH_CONFIG = {
+    defaultMethod: 'api-key-header',
+    apiKeys: [],
+    headerInjection: {
+        static: {},
+        dynamic: [],
+    },
+    session: {
+        enabled: false,
+        timeoutMs: 3600000, // 1 hour
+        storage: 'memory',
+    },
+};
+//# sourceMappingURL=auth.js.map

package/dist/types/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8LH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,aAAa,EAAE,gBAAgB;IAC/B,OAAO,EAAE,EAAE;IACX,eAAe,EAAE;QACf,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;KACZ;IACD,OAAO,EAAE;QACP,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,OAAO,EAAE,QAAQ;KAClB;CACF,CAAC"}