@ansvar/eu-regulations-mcp 1.0.0 → 1.1.0

package/scripts/test-postgres-adapter.ts

@@ -1,146 +0,0 @@
-#!/usr/bin/env npx tsx
-
-/**
- * Test PostgreSQL adapter with migrated data
- *
- * Usage:
- *   DATABASE_URL=postgresql://... npx tsx scripts/test-postgres-adapter.ts
- */
-
-import { PostgreSQLAdapter } from '../packages/core/src/adapters/postgresql-adapter.js';
-
-async function main() {
-  console.log('🧪 Testing PostgreSQL Adapter\n');
-
-  const connectionString = process.env.DATABASE_URL;
-  if (!connectionString) {
-    console.error('❌ DATABASE_URL environment variable is required');
-    process.exit(1);
-  }
-
-  console.log(`🐘 Connecting to: ${connectionString.replace(/:[^:@]+@/, ':***@')}\n`);
-
-  const adapter = new PostgreSQLAdapter(connectionString);
-
-  try {
-    // Test 1: Connection
-    console.log('Test 1: Connection');
-    const connected = await adapter.testConnection();
-    console.log(connected ? '✅ Connected\n' : '❌ Connection failed\n');
-    if (!connected) process.exit(1);
-
-    // Test 2: Get all regulations
-    console.log('Test 2: Get all regulations');
-    const regulations = await adapter.getAllRegulations();
-    console.log(`✅ Found ${regulations.length} regulations`);
-    console.log(`   First 3: ${regulations.slice(0, 3).map(r => r.id).join(', ')}\n`);
-
-    // Test 3: Get specific regulation
-    console.log('Test 3: Get specific regulation (GDPR)');
-    const gdpr = await adapter.getRegulationById('GDPR');
-    if (gdpr) {
-      console.log(`✅ ${gdpr.full_name}`);
-      console.log(`   CELEX: ${gdpr.celex_id}\n`);
-    } else {
-      console.log('❌ GDPR not found\n');
-      process.exit(1);
-    }
-
-    // Test 4: Search articles
-    console.log('Test 4: Search articles for "incident reporting"');
-    const searchResults = await adapter.searchArticles('incident reporting', undefined, 5);
-    console.log(`✅ Found ${searchResults.length} results`);
-    searchResults.forEach((result, i) => {
-      console.log(`   ${i + 1}. ${result.item.regulation} Article ${result.item.article_number}: ${result.item.title}`);
-      console.log(`      Rank: ${result.rank.toFixed(4)}`);
-    });
-    console.log();
-
-    // Test 5: Get specific article
-    console.log('Test 5: Get GDPR Article 17');
-    const article = await adapter.getArticle('GDPR', '17');
-    if (article) {
-      console.log(`✅ ${article.title}`);
-      console.log(`   Text length: ${article.text.length} characters`);
-      if (article.recitals) {
-        console.log(`   Related recitals: ${article.recitals}\n`);
-      }
-    } else {
-      console.log('❌ Article not found\n');
-      process.exit(1);
-    }
-
-    // Test 6: Get recital
-    console.log('Test 6: Get GDPR Recital 1');
-    const recital = await adapter.getRecital('GDPR', 1);
-    if (recital) {
-      console.log(`✅ Text: ${recital.text.substring(0, 100)}...`);
-      console.log(`   Full length: ${recital.text.length} characters\n`);
-    } else {
-      console.log('❌ Recital not found\n');
-      process.exit(1);
-    }
-
-    // Test 7: Search recitals
-    console.log('Test 7: Search recitals for "data protection"');
-    const recitalResults = await adapter.searchRecitals('data protection', 3);
-    console.log(`✅ Found ${recitalResults.length} recital results`);
-    recitalResults.forEach((result, i) => {
-      console.log(`   ${i + 1}. ${result.item.regulation} Recital ${result.item.recital_number}`);
-      console.log(`      Rank: ${result.rank.toFixed(4)}`);
-    });
-    console.log();
-
-    // Test 8: Get definitions
-    console.log('Test 8: Search definitions for "personal data"');
-    const definitions = await adapter.getDefinitions('personal data');
-    console.log(`✅ Found ${definitions.length} definitions`);
-    definitions.slice(0, 3).forEach((def, i) => {
-      console.log(`   ${i + 1}. ${def.regulation}: ${def.term}`);
-      console.log(`      ${def.definition.substring(0, 80)}...`);
-    });
-    console.log();
-
-    // Test 9: Get control mappings
-    console.log('Test 9: Get ISO 27001 control mappings');
-    const mappings = await adapter.getControlMappings('ISO27001', undefined, undefined);
-    console.log(`✅ Found ${mappings.length} ISO 27001 mappings`);
-    const sample = mappings.slice(0, 2);
-    sample.forEach((map, i) => {
-      console.log(`   ${i + 1}. ${map.control_id}: ${map.control_name}`);
-      console.log(`      → ${map.regulation} (${map.coverage})`);
-    });
-    console.log();
-
-    // Test 10: Get applicability rules
-    console.log('Test 10: Get applicability rules for financial sector');
-    const rules = await adapter.getApplicabilityRules('financial');
-    console.log(`✅ Found ${rules.length} applicability rules`);
-    rules.slice(0, 3).forEach((rule, i) => {
-      console.log(`   ${i + 1}. ${rule.regulation}: ${rule.applies ? 'Applies' : 'Does not apply'}`);
-      console.log(`      Confidence: ${rule.confidence}`);
-    });
-    console.log();
-
-    // Test 11: Statistics
-    console.log('Test 11: Get database statistics');
-    const stats = await adapter.getStatistics();
-    console.log('✅ Statistics:');
-    console.log(`   Regulations:        ${stats.regulations}`);
-    console.log(`   Articles:           ${stats.articles}`);
-    console.log(`   Recitals:           ${stats.recitals}`);
-    console.log(`   Definitions:        ${stats.definitions}`);
-    console.log(`   Control Mappings:   ${stats.control_mappings}\n`);
-
-    console.log('='.repeat(60));
-    console.log('✅ All tests passed!');
-    console.log('='.repeat(60));
-  } catch (error) {
-    console.error('\n❌ Test failed:', error);
-    process.exit(1);
-  } finally {
-    await adapter.close();
-  }
-}
-
-main();

package/scripts/update-dora-rts-metadata.ts

@@ -1,112 +0,0 @@
-#!/usr/bin/env node
-/**
- * Update metadata for DORA RTS/ITS JSON files
- */
-import * as fs from 'fs';
-import * as path from 'path';
-
-interface RegulationMetadata {
-  id: string;
-  full_name: string;
-  effective_date: string;
-}
-
-const DORA_RTS_ITS_METADATA: Record<string, RegulationMetadata> = {
-  '32024R1774': {
-    id: 'DORA_RTS_ICT_RISK',
-    full_name: 'Commission Delegated Regulation (EU) 2024/1774 - ICT Risk Management Tools, Methods, Processes and Simplified Framework',
-    effective_date: '2025-01-17',
-  },
-  '32024R1772': {
-    id: 'DORA_RTS_INCIDENT_CLASS',
-    full_name: 'Commission Delegated Regulation (EU) 2024/1772 - Classification of ICT-Related Incidents and Cyber Threats',
-    effective_date: '2025-01-17',
-  },
-  '32024R1773': {
-    id: 'DORA_RTS_ICT_SERVICES',
-    full_name: 'Commission Delegated Regulation (EU) 2024/1773 - Policy on ICT Services Supporting Critical or Important Functions',
-    effective_date: '2025-01-17',
-  },
-  '32024R2956': {
-    id: 'DORA_ITS_REGISTER',
-    full_name: 'Commission Implementing Regulation (EU) 2024/2956 - Standard Templates for Register of Information',
-    effective_date: '2025-01-17',
-  },
-  '32024R1502': {
-    id: 'DORA_RTS_CRITICAL_PROVIDER',
-    full_name: 'Commission Delegated Regulation (EU) 2024/1502 - Criteria for Designation of Critical ICT Third-Party Service Providers',
-    effective_date: '2025-01-17',
-  },
-  '32024R1505': {
-    id: 'DORA_RTS_OVERSIGHT_FEES',
-    full_name: 'Commission Delegated Regulation (EU) 2024/1505 - Oversight Fees for Critical ICT Third-Party Service Providers',
-    effective_date: '2025-01-17',
-  },
-  '32025R0295': {
-    id: 'DORA_RTS_OVERSIGHT',
-    full_name: 'Commission Delegated Regulation (EU) 2025/295 - Harmonization of Oversight Activities Conditions',
-    effective_date: '2025-01-17',
-  },
-  '32025R0301': {
-    id: 'DORA_RTS_INCIDENT_REPORTING',
-    full_name: 'Commission Delegated Regulation (EU) 2025/301 - Content and Time Limits for Incident Reporting',
-    effective_date: '2025-01-17',
-  },
-  '32025R0302': {
-    id: 'DORA_ITS_INCIDENT_FORMS',
-    full_name: 'Commission Implementing Regulation (EU) 2025/302 - Standard Forms and Templates for Incident Reporting',
-    effective_date: '2025-01-17',
-  },
-  '32025R1190': {
-    id: 'DORA_RTS_TLPT',
-    full_name: 'Commission Delegated Regulation (EU) 2025/1190 - Threat-Led Penetration Testing (TLPT)',
-    effective_date: '2025-01-17',
-  },
-};
-
-const FILE_MAPPING: Record<string, string> = {
-  '32024R1774': 'data/seed/dora-rts-ict-risk.json',
-  '32024R1772': 'data/seed/dora-rts-incident-classification.json',
-  '32024R1773': 'data/seed/dora-rts-ict-services-policy.json',
-  '32024R2956': 'data/seed/dora-its-register-templates.json',
-  '32024R1502': 'data/seed/dora-rts-critical-provider-designation.json',
-  '32024R1505': 'data/seed/dora-rts-oversight-fees.json',
-  '32025R0295': 'data/seed/dora-rts-oversight-harmonization.json',
-  '32025R0301': 'data/seed/dora-rts-incident-reporting.json',
-  '32025R0302': 'data/seed/dora-its-incident-forms.json',
-  '32025R1190': 'data/seed/dora-rts-tlpt.json',
-};
-
-function updateRegulationMetadata(celex: string, filePath: string): void {
-  const metadata = DORA_RTS_ITS_METADATA[celex];
-  if (!metadata) {
-    console.error(`No metadata found for CELEX ${celex}`);
-    return;
-  }
-
-  const fullPath = path.resolve(process.cwd(), filePath);
-  if (!fs.existsSync(fullPath)) {
-    console.error(`File not found: ${fullPath}`);
-    return;
-  }
-
-  const data = JSON.parse(fs.readFileSync(fullPath, 'utf-8'));
-
-  // Update metadata
-  data.id = metadata.id;
-  data.full_name = metadata.full_name;
-  data.effective_date = metadata.effective_date;
-
-  // Write back
-  fs.writeFileSync(fullPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
-  console.log(`✅ Updated ${celex} → ${metadata.id} (${filePath})`);
-}
-
-// Main
-console.log('Updating DORA RTS/ITS metadata...\n');
-
-for (const [celex, filePath] of Object.entries(FILE_MAPPING)) {
-  updateRegulationMetadata(celex, filePath);
-}
-
-console.log('\n✅ All metadata updated successfully!');

package/src/database/postgres-adapter.ts

@@ -1,84 +0,0 @@
-import pg from 'pg';
-import type { DatabaseAdapter, QueryResult } from './types.js';
-
-export async function createPostgresAdapter(
-  connectionString: string
-): Promise<DatabaseAdapter> {
-  const pool = new pg.Pool({
-    connectionString,
-    max: 10,
-    idleTimeoutMillis: 30000,
-    connectionTimeoutMillis: 10000,
-  });
-
-  // Test connection
-  try {
-    await pool.query('SELECT 1');
-  } catch (error) {
-    throw new Error(`Failed to connect to PostgreSQL: ${error}`);
-  }
-
-  return {
-    type: 'postgres' as const,
-
-    async query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>> {
-      const QUERY_TIMEOUT_MS = 10000; // 10 seconds
-
-      try {
-        // Create timeout promise
-        const timeoutPromise = new Promise<never>((_, reject) => {
-          setTimeout(() => {
-            reject(new Error('Database query timeout: Query exceeded 10 seconds'));
-          }, QUERY_TIMEOUT_MS);
-        });
-
-        // Race between query and timeout
-        const result = await Promise.race([
-          pool.query(sql, params),
-          timeoutPromise,
-        ]);
-
-        return {
-          rows: result.rows as T[],
-          rowCount: result.rowCount || 0,
-        };
-      } catch (error) {
-        const pgError = error as {
-          code?: string;
-          message: string;
-          detail?: string;
-        };
-        console.error('PostgreSQL query failed:', {
-          sql: sql.substring(0, 100), // Truncate for logging
-          params,
-          code: pgError.code,
-          message: pgError.message,
-          detail: pgError.detail,
-        });
-
-        // Check for timeout error
-        if (pgError.message?.includes('timeout')) {
-          throw new Error(
-            'Database query timeout: Query exceeded 10 seconds'
-          );
-        }
-
-        // Provide helpful error messages based on error code
-        if (pgError.code?.startsWith('08')) {
-          throw new Error(`Database connection error: ${pgError.message}`);
-        }
-        if (pgError.code === '42P01') {
-          throw new Error(`Table not found: ${pgError.message}`);
-        }
-
-        throw new Error(
-          `Query failed: ${pgError.message}${pgError.code ? ` (${pgError.code})` : ''}`
-        );
-      }
-    },
-
-    async close(): Promise<void> {
-      await pool.end();
-    },
-  };
-}

package/src/database/sqlite-adapter.ts

@@ -1,44 +0,0 @@
-import type Database from 'better-sqlite3';
-import type { DatabaseAdapter, QueryResult } from './types.js';
-
-/**
- * Adapter that wraps better-sqlite3 Database to match DatabaseAdapter interface.
- * Allows existing SQLite-based entry points (stdio) to work with the new adapter interface.
- */
-export function createSqliteAdapter(db: Database.Database): DatabaseAdapter {
-  return {
-    type: 'sqlite' as const,
-
-    async query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>> {
-      try {
-        // Convert PostgreSQL syntax to SQLite syntax
-        let sqliteSql = sql
-          // Convert $1, $2 placeholders to ?
-          .replace(/\$\d+/g, '?')
-          // Convert ILIKE to LIKE (SQLite is case-insensitive by default with LIKE)
-          .replace(/\sILIKE\s/gi, ' LIKE ')
-          // Convert ::TEXT type casting to CAST(... AS TEXT)
-          .replace(/(\w+)::TEXT/g, 'CAST($1 AS TEXT)')
-          .replace(/(\w+)::INTEGER/g, 'CAST($1 AS INTEGER)')
-          // Convert DISTINCT ON (col) to GROUP BY col
-          // PostgreSQL: SELECT DISTINCT ON (col1) col1, col2 FROM ... ORDER BY col1, col2
-          // SQLite: SELECT col1, col2 FROM ... GROUP BY col1 HAVING MIN(col2) = col2
-          .replace(/SELECT\s+DISTINCT\s+ON\s*\([^)]+\)/gi, 'SELECT');
-
-        const stmt = db.prepare(sqliteSql);
-        const rows = params ? stmt.all(...params) : stmt.all();
-        return {
-          rows: rows as T[],
-          rowCount: rows.length,
-        };
-      } catch (error) {
-        console.error('SQLite query failed:', sql, params, error);
-        throw error;
-      }
-    },
-
-    async close(): Promise<void> {
-      db.close();
-    },
-  };
-}

package/src/database/types.ts

@@ -1,10 +0,0 @@
-export interface QueryResult<T = any> {
-  rows: T[];
-  rowCount: number;
-}
-
-export interface DatabaseAdapter {
-  query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
-  close(): Promise<void>;
-  type: 'sqlite' | 'postgres';
-}

package/src/http-server.ts

@@ -1,149 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * HTTP Server Entry Point for Smithery Hosted Deployment
- *
- * This provides Streamable HTTP transport for remote MCP clients.
- * Use src/index.ts for local stdio-based usage.
- */
-
-import { createServer } from 'node:http';
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
-import Database from 'better-sqlite3';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import { randomUUID } from 'crypto';
-
-import { registerTools } from './tools/registry.js';
-import { createSqliteAdapter } from './database/sqlite-adapter.js';
-import type { DatabaseAdapter } from './database/types.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Database path - look for regulations.db in data folder
-const DB_PATH = process.env.EU_COMPLIANCE_DB_PATH || join(__dirname, '..', 'data', 'regulations.db');
-
-// HTTP server port
-const PORT = parseInt(process.env.PORT || '3000', 10);
-
-let db: DatabaseAdapter;
-
-function getDatabase(): DatabaseAdapter {
-  if (!db) {
-    try {
-      const sqliteDb = new Database(DB_PATH, { readonly: true });
-      db = createSqliteAdapter(sqliteDb);
-    } catch (error) {
-      throw new Error(`Failed to open database at ${DB_PATH}: ${error}`);
-    }
-  }
-  return db;
-}
-
-// Create MCP server instance
-function createMcpServer(): Server {
-  const db = getDatabase();
-  const server = new Server(
-    {
-      name: 'eu-regulations-mcp',
-      version: '0.1.0',
-    },
-    {
-      capabilities: {
-        tools: {},
-      },
-    }
-  );
-
-  // Register all tools using shared registry
-  registerTools(server, db);
-
-  return server;
-}
-
-// Start HTTP server with Streamable HTTP transport
-async function main() {
-  const mcpServer = createMcpServer();
-
-  // Map to store transports by session ID
-  const transports = new Map<string, StreamableHTTPServerTransport>();
-
-  const httpServer = createServer(async (req, res) => {
-    const url = new URL(req.url || '/', `http://localhost:${PORT}`);
-
-    // Health check endpoint
-    if (url.pathname === '/health') {
-      res.writeHead(200, { 'Content-Type': 'application/json' });
-      res.end(JSON.stringify({ status: 'ok', server: 'eu-regulations-mcp' }));
-      return;
-    }
-
-    // MCP endpoint
-    if (url.pathname === '/mcp') {
-      // Get or create session
-      const sessionId = req.headers['mcp-session-id'] as string | undefined;
-
-      let transport: StreamableHTTPServerTransport;
-
-      if (sessionId && transports.has(sessionId)) {
-        // Reuse existing transport for this session
-        transport = transports.get(sessionId)!;
-      } else {
-        // Create new transport with session ID generator
-        transport = new StreamableHTTPServerTransport({
-          sessionIdGenerator: () => randomUUID(),
-        });
-
-        // Connect MCP server to transport
-        await mcpServer.connect(transport);
-
-        // Store transport by session ID once it's assigned
-        transport.onclose = () => {
-          if (transport.sessionId) {
-            transports.delete(transport.sessionId);
-          }
-        };
-      }
-
-      // Handle the request
-      await transport.handleRequest(req, res);
-
-      // Store transport if new session was created
-      if (transport.sessionId && !transports.has(transport.sessionId)) {
-        transports.set(transport.sessionId, transport);
-      }
-
-      return;
-    }
-
-    // 404 for other paths
-    res.writeHead(404, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ error: 'Not found' }));
-  });
-
-  httpServer.listen(PORT, () => {
-    console.error(`EU Regulations MCP server (HTTP) listening on port ${PORT}`);
-    console.error(`MCP endpoint: http://localhost:${PORT}/mcp`);
-    console.error(`Health check: http://localhost:${PORT}/health`);
-  });
-
-  // Graceful shutdown
-  process.on('SIGTERM', () => {
-    console.error('Received SIGTERM, shutting down...');
-    httpServer.close(() => {
-      if (db) db.close();
-      process.exit(0);
-    });
-  });
-}
-
-main().catch((error) => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});

package/src/index.ts

@@ -1,61 +0,0 @@
-#!/usr/bin/env node
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
-import Database from 'better-sqlite3';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-import { registerTools } from './tools/registry.js';
-import { createSqliteAdapter } from './database/sqlite-adapter.js';
-import type { DatabaseAdapter } from './database/types.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// Database path - look for regulations.db in data folder
-const DB_PATH = process.env.EU_COMPLIANCE_DB_PATH || join(__dirname, '..', 'data', 'regulations.db');
-
-let db: DatabaseAdapter;
-
-function getDatabase(): DatabaseAdapter {
-  if (!db) {
-    try {
-      const sqliteDb = new Database(DB_PATH, { readonly: true });
-      db = createSqliteAdapter(sqliteDb);
-    } catch (error) {
-      throw new Error(`Failed to open database at ${DB_PATH}: ${error}`);
-    }
-  }
-  return db;
-}
-const server = new Server(
-  {
-    name: 'eu-regulations-mcp',
-    version: '0.1.0',
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
-  }
-);
-
-// Register all tools using shared registry
-registerTools(server, getDatabase());
-
-// Start the server
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error('EU Regulations MCP server started');
-}
-
-main().catch((error) => {
-  console.error('Fatal error:', error);
-  process.exit(1);
-});