mcp-adr-analysis-server
Version:
MCP server for analyzing Architectural Decision Records and project architecture
118 lines • 4.36 kB
JavaScript
/**
* Configuration management for MCP ADR Analysis Server
* Handles environment variables and default settings
*/
import path from 'path';
import { z } from 'zod';
/**
* Configuration schema for validation
*/
const ConfigSchema = z.object({
projectPath: z.string().min(1, 'PROJECT_PATH is required'),
adrDirectory: z.string().default('docs/adrs'),
logLevel: z.enum(['DEBUG', 'INFO', 'WARN', 'ERROR']).default('INFO'),
cacheEnabled: z.boolean().default(true),
cacheDirectory: z.string().default('.mcp-adr-cache'),
maxCacheSize: z.number().default(100 * 1024 * 1024), // 100MB
analysisTimeout: z.number().default(30000), // 30 seconds
});
/**
* Load and validate configuration from environment variables
*/
export function loadConfig() {
// Get PROJECT_PATH from environment or use current working directory
const projectPath = process.env['PROJECT_PATH'] || process.cwd();
// Resolve to absolute path
const absoluteProjectPath = path.resolve(projectPath);
const rawConfig = {
projectPath: absoluteProjectPath,
adrDirectory: process.env['ADR_DIRECTORY'] || 'docs/adrs',
logLevel: (process.env['LOG_LEVEL'] || 'INFO').toUpperCase(),
cacheEnabled: process.env['CACHE_ENABLED'] !== 'false',
cacheDirectory: process.env['CACHE_DIRECTORY'] || '.mcp-adr-cache',
maxCacheSize: parseInt(process.env['MAX_CACHE_SIZE'] || '104857600'), // 100MB
analysisTimeout: parseInt(process.env['ANALYSIS_TIMEOUT'] || '30000'), // 30 seconds
};
try {
return ConfigSchema.parse(rawConfig);
}
catch (error) {
if (error instanceof z.ZodError) {
const issues = error.issues
.map(issue => `${issue.path.join('.')}: ${issue.message}`)
.join(', ');
throw new Error(`Configuration validation failed: ${issues}`);
}
throw error;
}
}
/**
* Get the absolute path for ADR directory
*/
export function getAdrDirectoryPath(config) {
return path.resolve(config.projectPath, config.adrDirectory);
}
/**
* Get the absolute path for cache directory
*/
export function getCacheDirectoryPath(config) {
return path.resolve(config.projectPath, config.cacheDirectory);
}
/**
* Validate that the project path exists and is accessible
*/
export async function validateProjectPath(projectPath) {
const fs = await import('fs/promises');
try {
const stats = await fs.stat(projectPath);
if (!stats.isDirectory()) {
throw new Error(`PROJECT_PATH is not a directory: ${projectPath}`);
}
}
catch (error) {
if (error.code === 'ENOENT') {
throw new Error(`PROJECT_PATH does not exist: ${projectPath}`);
}
throw new Error(`Cannot access PROJECT_PATH: ${projectPath} - ${error.message}`);
}
}
/**
* Create logger with configured log level
*/
export function createLogger(config) {
const levels = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
const currentLevel = levels[config.logLevel] || 1;
return {
debug: (message, ...args) => {
if (currentLevel <= 0)
console.error(`[DEBUG] ${message}`, ...args);
},
info: (message, ...args) => {
if (currentLevel <= 1)
console.error(`[INFO] ${message}`, ...args);
},
warn: (message, ...args) => {
if (currentLevel <= 2)
console.error(`[WARN] ${message}`, ...args);
},
error: (message, ...args) => {
if (currentLevel <= 3)
console.error(`[ERROR] ${message}`, ...args);
},
};
}
/**
* Print configuration summary for debugging
*/
export function printConfigSummary(config) {
const logger = createLogger(config);
logger.info('MCP ADR Analysis Server Configuration:');
logger.info(` Project Path: ${config.projectPath}`);
logger.info(` ADR Directory: ${config.adrDirectory}`);
logger.info(` Log Level: ${config.logLevel}`);
logger.info(` Cache Enabled: ${config.cacheEnabled}`);
logger.info(` Cache Directory: ${config.cacheDirectory}`);
logger.info(` Max Cache Size: ${Math.round(config.maxCacheSize / 1024 / 1024)}MB`);
logger.info(` Analysis Timeout: ${config.analysisTimeout}ms`);
}
//# sourceMappingURL=config.js.map