accessflow-mcp-server 1.0.0-cicd-npm.1

package/README.md

@@ -0,0 +1,122 @@
+[![accessFlow MCP](https://accessflow.accessibe.com/media/MCP-banner.png)](http://accessibe.com/accessflow)
+
+# AccessFlow MCP Server
+
+A Model Context Protocol (MCP) server that provides intelligent accessibility issue analysis and remediation guidance. This server connects to the accessFlow platform to help developers identify, prioritize, and fix accessibility issues in their web applications.
+
+## 🎯 Purpose
+
+The accessFlow MCP Server enables AI clients (like Copilot) to:
+
+- **Identify Priority Issues**: Get the most urgent accessibility issues ordered by severity and impact
+- **Provide Fix Guidance**: Generate detailed remediation instructions with code examples
+- **WCAG Compliance**: Reference specific WCAG guidelines and criteria for each issue
+- **Streamline Workflow**: Integrate accessibility testing directly into your development environment
+
+## 🛠️ Available Tools
+
+### `getMostUrgentIssues`
+
+Retrieves the most critical accessibility issues, prioritized by:
+
+1. **Severity**: EXTREME → HIGH → MEDIUM → LOW
+2. **Site Impact**: Number of locations affected across the site
+3. **Page Impact**: Number of occurrences on individual pages
+
+**Parameters**: None (uses configured domain)
+
+**Returns**: JSON data with structured issue information including severity, WCAG level, occurrence counts, and unique identifiers.
+
+### `getIssueRemediation`
+
+Provides detailed remediation guidance for a specific accessibility issue.
+
+**Parameters**:
+
+- `issueDisplayName` (string, required): The unique identifier for the accessibility issue
+
+**Returns**: Comprehensive fix guidance including:
+
+- Problem summary and WCAG references
+- Current problematic code
+- Suggested code fixes with examples
+- Step-by-step remediation instructions
+- Links to tutorials and additional resources
+
+### `resolveIssue`
+
+Marks the specified issue as resolved in accessFlow.
+Note: If the next audit still detects this issue, it will be reopened automatically.
+
+**Parameters**:
+
+- `issueDisplayName` (string, required): The unique identifier for the accessibility issue
+
+## 📋 Usage
+
+### Configuration
+
+Add the following configuration to your MCP client (e.g., VS Code Copilot Agent):
+
+```json
+{
+  "mcpServers": {
+    "flow-mcp": {
+      "command": "npx",
+      "args": ["-y", "accessflow-mcp-server"],
+      "env": {
+        "API_KEY": "your-accessflow-api-key",
+        "DOMAIN": "https://your-app-domain.com"
+      },
+      "type": "stdio"
+    }
+  }
+}
+```
+
+#### Configuration Parameters
+
+- **`API_KEY`** (required): Your accessFlow API key for authentication
+- **`DOMAIN`** (required): The domain of your application being analyzed (e.g., `example.com` - without protocol)
+- **`ENVIRONMENT`** (optional): API environment URL (defaults to `https://accessflow.accessibe.com`)
+
+#### Environment Setup
+
+For local development, create a `.env` file in the project root:
+
+```bash
+# Required: Your domain name (without protocol)
+DOMAIN=your-domain.com
+
+# Required: Your accessFlow API key
+API_KEY=your-api-key-here
+
+# Optional: Environment URL (defaults to production)
+ENVIRONMENT=https://accessflow.accessibe.com
+```
+
+**Important**: Replace `your-domain.com` and `your-api-key-here` with your actual values before running the server.
+
+### 3. Example Usage
+
+Once configured, you can interact with the server through your MCP client:
+
+**Get Priority Issues:**
+
+```text
+"Show me the most urgent accessibility issues for my site"
+```
+
+**Get Specific Remediation:**
+
+```text
+"Get remediation guidance for issue: Decorative-Content-6d277a13ba"
+```
+
+## Supported Clients
+
+This MCP server works with AI agents in IDEs and other MCP-compatible clients:
+
+- **VS Code Copilot**: Integrates with GitHub Copilot in VS Code
+- **Cursor**: Works with Cursor's AI assistant
+- **Other MCP Clients**: Any application supporting the Model Context Protocol

package/dist/http-server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/http-server.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { FlowMcpServer } from './server.js';
+import { logger } from './services/loggerService.js';
+async function startServer() {
+    try {
+        console.log('Starting HTTP server...');
+        // Get port from environment variable or use default
+        const port = process.env.PORT ? parseInt(process.env.PORT, 10) : 8080;
+        const stateless = process.env.STATELESS === 'true';
+        const transportConfig = {
+            type: 'httpStream',
+            port,
+            host: '0.0.0.0', // Listen on all network interfaces
+            stateless,
+        };
+        console.log('Creating server instance...');
+        const server = new FlowMcpServer(transportConfig);
+        // Handle graceful shutdown
+        process.on('SIGINT', async () => {
+            logger.info('Received SIGINT, shutting down gracefully...');
+            await server.stop();
+            logger.info('Server stopped successfully');
+            process.exit(0);
+        });
+        process.on('SIGTERM', async () => {
+            logger.info('Received SIGTERM, shutting down gracefully...');
+            await server.stop();
+            logger.info('Server stopped successfully');
+            process.exit(0);
+        });
+        console.log('Initializing server...');
+        // Start server with HTTP transport
+        await server.init();
+        logger.info(`HTTP server is running at http://${transportConfig.host}:${port}/mcp`);
+        console.log(`HTTP server is running at http://${transportConfig.host}:${port}/mcp`);
+    }
+    catch (error) {
+        console.error('Error starting HTTP server:', error);
+        logger.error({
+            error: error instanceof Error ? error.message : 'Unknown error',
+            stack: error instanceof Error ? error.stack : undefined,
+        }, 'Failed to start Flow MCP HTTP Server');
+        // Exit code 1 will indicate failure to the parent process
+        process.exit(1);
+    }
+}
+// Add top-level error handlers
+process.on('uncaughtException', (error) => {
+    console.error('Uncaught exception:', error);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason, promise) => {
+    console.error('Unhandled rejection at:', promise, 'reason:', reason);
+    process.exit(1);
+});
+startServer();
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAEvC,oDAAoD;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM,CAAC;QAEnD,MAAM,eAAe,GAAG;YACtB,IAAI,EAAE,YAAqB;YAC3B,IAAI;YACJ,IAAI,EAAE,SAAS,EAAE,mCAAmC;YACpD,SAAS;SACV,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;QAElD,2BAA2B;QAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC5D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC7D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,mCAAmC;QACnC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,oCAAoC,eAAe,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,CAAC,oCAAoC,eAAe,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CACV;YACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;YAC/D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACxD,EACD,sCAAsC,CACvC,CAAC;QAEF,0DAA0D;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+BAA+B;AAC/B,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,WAAW,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+import { FlowMcpServer } from './server.js';
+import { logger } from './services/loggerService.js';
+async function startServer() {
+    const transportConfig = { type: 'stdio' };
+    const server = new FlowMcpServer(transportConfig);
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        logger.info('Received SIGINT, shutting down gracefully...');
+        await server.stop();
+        logger.info('Server stopped successfully');
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        logger.info('Received SIGTERM, shutting down gracefully...');
+        await server.stop();
+        logger.info('Server stopped successfully');
+        process.exit(0);
+    });
+    try {
+        // Start server with stdio transport (default for MCP clients)
+        await server.init();
+    }
+    catch (error) {
+        logger.error({
+            error: error instanceof Error ? error.message : 'Unknown error',
+            stack: error instanceof Error ? error.stack : undefined,
+        }, 'Failed to start Flow MCP Server');
+        // Exit code 1 will indicate failure to the parent process
+        process.exit(1);
+    }
+}
+startServer();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,KAAK,UAAU,WAAW;IACxB,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAElD,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC7D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CACV;YACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;YAC/D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACxD,EACD,iCAAiC,CAClC,CAAC;QAEF,0DAA0D;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,WAAW,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,28 @@
+import 'dotenv/config';
+export type TransportConfig = {
+    type: 'stdio';
+} | {
+    type: 'httpStream';
+    port: number;
+    host?: string;
+    stateless?: boolean;
+};
+export interface SessionData {
+    apiKey: string;
+    domain: string;
+    environment?: string;
+    nonProdUsername?: string;
+    nonProdPassword?: string;
+    [key: string]: unknown;
+}
+export declare class FlowMcpServer {
+    private readonly options;
+    private readonly server;
+    private readonly environment;
+    private readonly transportConfig;
+    private stdioApiService?;
+    constructor(transportConfig: TransportConfig);
+    init(): Promise<this>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAQvB,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAGlD,OAAO,CAAC,eAAe,CAAC,CAAa;gBAEzB,eAAe,EAAE,eAAe;IAoItC,IAAI;IAqFJ,IAAI;CAGX"}

package/dist/server.js

@@ -0,0 +1,181 @@
+import 'dotenv/config';
+import { FastMCP } from 'fastmcp';
+import packageJson from '../package.json' with { type: 'json' };
+import { registerTools } from './tools/index.js';
+import { sanitizeDomain } from './utils/domains.js';
+import { ApiService } from './services/apiService.js';
+import { logger } from './services/loggerService.js';
+export class FlowMcpServer {
+    options;
+    server;
+    environment;
+    transportConfig;
+    // For stdio mode only
+    stdioApiService;
+    constructor(transportConfig) {
+        this.transportConfig = transportConfig;
+        this.environment =
+            process.env.ENVIRONMENT || 'https://accessflow.accessibe.com';
+        const nonProdUserName = process.env.NON_PROD_USER_NAME;
+        const nonProdPassword = process.env.NON_PROD_PASSWORD;
+        // Configure server options based on transport type
+        if (transportConfig.type === 'httpStream') {
+            // HTTP mode: Extract credentials from headers per-request
+            this.options = {
+                name: 'accessFlow MCP Server',
+                version: packageJson.version,
+                authenticate: async (request) => {
+                    // Helper function for case-insensitive header lookup
+                    const getHeader = (name) => {
+                        const lowerName = name.toLowerCase();
+                        // Try lowercase first (most common)
+                        if (request.headers[lowerName]) {
+                            return request.headers[lowerName];
+                        }
+                        // Try exact case
+                        if (request.headers[name]) {
+                            return request.headers[name];
+                        }
+                        // Search case-insensitively through all headers
+                        for (const [key, value] of Object.entries(request.headers)) {
+                            if (key.toLowerCase() === lowerName) {
+                                return value;
+                            }
+                        }
+                        return undefined;
+                    };
+                    // Log all headers for debugging
+                    logger.debug({ headers: Object.keys(request.headers) }, 'Incoming HTTP request headers');
+                    // Extract Authorization header (Bearer token)
+                    const authHeader = getHeader('authorization');
+                    const apiKey = authHeader?.replace(/^Bearer\s+/i, '') || '';
+                    // Extract X-Domain header
+                    const domainHeader = getHeader('x-domain');
+                    const domain = sanitizeDomain(domainHeader || '');
+                    // Extract optional X-Environment header (defaults to production)
+                    const environmentHeader = getHeader('x-environment');
+                    const environment = environmentHeader || 'https://accessflow.accessibe.com';
+                    // Extract optional non-prod basic auth credentials (for staging environments)
+                    const nonProdUsername = getHeader('x-nonprod-username');
+                    const nonProdPassword = getHeader('x-nonprod-password');
+                    if (nonProdUsername && nonProdPassword) {
+                        logger.debug({
+                            domain,
+                            hasNonProdCreds: true,
+                        }, 'Using non-prod credentials for API calls');
+                    }
+                    if (!apiKey || !domain) {
+                        logger.warn({
+                            hasAuthHeader: !!authHeader,
+                            hasDomainHeader: !!domainHeader,
+                            headerKeys: Object.keys(request.headers),
+                        }, 'Authentication failed: missing headers');
+                        throw new Response(null, {
+                            status: 401,
+                            statusText: 'Unauthorized: Missing Authorization or X-Domain header',
+                        });
+                    }
+                    logger.debug({
+                        domain,
+                        environment,
+                        apiKeyPrefix: apiKey.substring(0, 10) + '...',
+                    }, 'HTTP request authenticated');
+                    const sessionData = {
+                        apiKey,
+                        domain,
+                        environment,
+                    };
+                    // Only include nonProd credentials if they are defined
+                    if (nonProdUsername !== undefined) {
+                        sessionData.nonProdUsername = nonProdUsername;
+                    }
+                    if (nonProdPassword !== undefined) {
+                        sessionData.nonProdPassword = nonProdPassword;
+                    }
+                    return sessionData;
+                },
+            };
+        }
+        else {
+            // stdio mode: Use environment variables (backward compatible)
+            const domain = sanitizeDomain(process.env.DOMAIN || '');
+            const apiKey = process.env.API_KEY || '';
+            this.stdioApiService = new ApiService(this.environment, domain, apiKey, nonProdUserName, nonProdPassword);
+            this.options = {
+                name: 'accessFlow MCP Server',
+                version: packageJson.version,
+            };
+        }
+        this.server = new FastMCP(this.options);
+    }
+    async init() {
+        const transportType = this.transportConfig.type;
+        const transportMode = transportType === 'stdio' ? 'stdio' : 'HTTP';
+        logger.info(`Initializing Flow MCP Server (${transportMode} mode)...`);
+        const nonProdUserName = process.env.NON_PROD_USER_NAME;
+        const nonProdPassword = process.env.NON_PROD_PASSWORD;
+        // Register tools with appropriate configuration
+        if (transportType === 'stdio') {
+            // stdio mode: Use pre-created ApiService
+            if (!this.stdioApiService) {
+                throw new Error('ApiService not initialized for stdio mode');
+            }
+            registerTools(this.server, {
+                mode: 'stdio',
+                apiService: this.stdioApiService,
+            });
+        }
+        else {
+            // HTTP mode: Create ApiService per-request from session
+            registerTools(this.server, {
+                mode: 'http',
+                createApiService: (session) => {
+                    // Use environment from session (X-Environment header) or fall back to default
+                    const environment = session.environment || 'https://accessflow.accessibe.com';
+                    // Use credentials from session headers, or fall back to environment variables
+                    const username = session.nonProdUsername || nonProdUserName;
+                    const password = session.nonProdPassword || nonProdPassword;
+                    return new ApiService(environment, session.domain, session.apiKey, username, password);
+                },
+            });
+        }
+        // Start the FastMCP server with the specified transport
+        if (transportType === 'stdio') {
+            await this.server.start({
+                transportType: 'stdio',
+            });
+        }
+        else {
+            const httpStreamConfig = {
+                port: this.transportConfig.port,
+                ...(this.transportConfig.host !== undefined && {
+                    host: this.transportConfig.host,
+                }),
+            };
+            if (this.transportConfig.stateless !== undefined) {
+                httpStreamConfig.stateless = this.transportConfig.stateless;
+            }
+            await this.server.start({
+                transportType: 'httpStream',
+                httpStream: httpStreamConfig,
+            });
+        }
+        logger.info({
+            environment: this.environment,
+            transport: transportMode,
+            ...(transportType === 'httpStream' && {
+                port: this.transportConfig.port,
+            }),
+            ...(transportType === 'stdio' &&
+                this.stdioApiService && {
+                domain: this.stdioApiService.domain,
+            }),
+        }, 'Flow MCP Server started successfully');
+        return this;
+    }
+    async stop() {
+        if (this.server)
+            await this.server.stop();
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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