mta-mcp 1.9.0 → 2.2.0

package/src/tools/healthCheck.ts

@@ -1,261 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-import { ConsoleLogger } from '../core/types.js';
-
-// ES 模块中获取 __dirname
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * 健康检查工具
- * 诊断 MCP 服务器配置和运行状态
- */
-export async function healthCheck(args: {
-    workspacePath?: string;
-    verbose?: boolean;
-}): Promise<{
-    content: Array<{ type: string; text: string }>;
-}> {
-    const logger = new ConsoleLogger();
-    const verbose = args.verbose ?? false;
-    
-    try {
-        const checks = {
-            server: { status: 'unknown', details: [] as string[] },
-            configuration: { status: 'unknown', details: [] as string[] },
-            dependencies: { status: 'unknown', details: [] as string[] },
-            standards: { status: 'unknown', details: [] as string[] },
-            workspace: { status: 'unknown', details: [] as string[] }
-        };
-
-        // Check 1: 服务器运行状态
-        logger.log('🔍 检查服务器状态...');
-        try {
-            checks.server.status = 'healthy';
-            checks.server.details.push('✅ MCP 服务器正在运行');
-            checks.server.details.push(`📍 进程 PID: ${process.pid}`);
-            checks.server.details.push(`🕐 运行时间: ${Math.floor(process.uptime())}秒`);
-        } catch {
-            checks.server.status = 'error';
-            checks.server.details.push('❌ 服务器未响应');
-        }
-
-        // Check 2: 配置文件
-        logger.log('🔍 检查配置文件...');
-        const workspacePath = args.workspacePath || process.cwd();
-        const vscodeDir = path.join(workspacePath, '.vscode');
-        
-        if (fs.existsSync(vscodeDir)) {
-            checks.workspace.status = 'healthy';
-            checks.workspace.details.push(`✅ 工作区路径: ${workspacePath}`);
-            
-            // mcp.json
-            const mcpJsonPath = path.join(vscodeDir, 'mcp.json');
-            if (fs.existsSync(mcpJsonPath)) {
-                try {
-                    const config = JSON.parse(fs.readFileSync(mcpJsonPath, 'utf-8'));
-                    
-                    // 检查新格式 (servers) 和旧格式 (mcpServers)
-                    const hasNewFormat = config.servers?.['copilot-prompts'];
-                    const hasOldFormat = config.mcpServers?.['copilot-prompts'];
-                    
-                    if (hasNewFormat) {
-                        checks.configuration.status = 'healthy';
-                        checks.configuration.details.push('✅ mcp.json 配置正确 (使用新格式)');
-                        
-                        const serverConfig = config.servers['copilot-prompts'];
-                        if (verbose) {
-                            checks.configuration.details.push(`  Command: ${serverConfig.command}`);
-                            checks.configuration.details.push(`  Args: ${serverConfig.args?.join(' ')}`);
-                            checks.configuration.details.push(`  AutoStart: ${serverConfig.autoStart ?? 'undefined'}`);
-                            checks.configuration.details.push(`  Env: ${JSON.stringify(serverConfig.env ?? {})}`);
-                        }
-                        
-                        // 检查是否包含推荐字段
-                        if (!serverConfig.env) {
-                            checks.configuration.details.push('💡 建议: 添加 "env": {} 字段');
-                        }
-                        if (!serverConfig.autoStart) {
-                            checks.configuration.details.push('💡 建议: 添加 "autoStart": true 字段');
-                        }
-                    } else if (hasOldFormat) {
-                        checks.configuration.status = 'warning';
-                        checks.configuration.details.push('⚠️  mcp.json 使用旧格式 (mcpServers)');
-                        checks.configuration.details.push('💡 建议: 运行 auto_setup 工具升级到新格式 (servers)');
-                        
-                        if (verbose) {
-                            const serverConfig = config.mcpServers['copilot-prompts'];
-                            checks.configuration.details.push(`  Command: ${serverConfig.command}`);
-                            checks.configuration.details.push(`  Args: ${serverConfig.args?.join(' ')}`);
-                        }
-                    } else {
-                        checks.configuration.status = 'warning';
-                        checks.configuration.details.push('⚠️  mcp.json 缺少 copilot-prompts 配置');
-                        checks.configuration.details.push('💡 建议: 运行 auto_setup 工具添加配置');
-                    }
-                } catch (error) {
-                    checks.configuration.status = 'error';
-                    checks.configuration.details.push(`❌ mcp.json 格式错误: ${error}`);
-                    checks.configuration.details.push('💡 修复: 运行 auto_setup 工具重新生成配置');
-                }
-            } else {
-                checks.configuration.status = 'warning';
-                checks.configuration.details.push('⚠️  mcp.json 不存在');
-                checks.configuration.details.push('💡 建议: 运行 auto_setup 工具自动配置');
-            }
-            
-            // settings.json
-            const settingsPath = path.join(vscodeDir, 'settings.json');
-            if (fs.existsSync(settingsPath)) {
-                try {
-                    const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-                    if (settings['github.copilot.chat.mcp.enabled'] === true) {
-                        checks.configuration.details.push('✅ VS Code MCP 已启用');
-                    } else {
-                        checks.configuration.details.push('⚠️  VS Code MCP 未启用');
-                    }
-                } catch {
-                    checks.configuration.details.push('⚠️  settings.json 格式错误');
-                }
-            }
-        } else {
-            checks.workspace.status = 'error';
-            checks.workspace.details.push('❌ .vscode 目录不存在');
-        }
-
-        // Check 3: 依赖检查
-        logger.log('🔍 检查依赖...');
-        const serverRoot = path.resolve(__dirname, '../..');
-        const packageJsonPath = path.join(serverRoot, 'package.json');
-        
-        if (fs.existsSync(packageJsonPath)) {
-            try {
-                const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-                checks.dependencies.status = 'healthy';
-                checks.dependencies.details.push(`✅ 服务器版本: ${pkg.version}`);
-                
-                if (verbose && pkg.dependencies) {
-                    const deps = Object.entries(pkg.dependencies).slice(0, 3);
-                    deps.forEach(([name, version]) => {
-                        checks.dependencies.details.push(`  ${name}: ${version}`);
-                    });
-                }
-                
-                // 检查关键依赖
-                const requiredDeps = ['@modelcontextprotocol/sdk'];
-                const missing = requiredDeps.filter(dep => !pkg.dependencies?.[dep]);
-                if (missing.length > 0) {
-                    checks.dependencies.status = 'error';
-                    checks.dependencies.details.push(`❌ 缺少依赖: ${missing.join(', ')}`);
-                }
-            } catch {
-                checks.dependencies.status = 'error';
-                checks.dependencies.details.push('❌ 无法读取 package.json');
-            }
-        }
-
-        // Check 4: 规范文件
-        logger.log('🔍 检查规范文件...');
-        const standardsDir = path.join(serverRoot, 'standards');
-        
-        if (fs.existsSync(standardsDir)) {
-            const categories = ['core', 'frameworks', 'libraries', 'patterns'];
-            const foundStandards: string[] = [];
-            
-            for (const category of categories) {
-                const categoryPath = path.join(standardsDir, category);
-                if (fs.existsSync(categoryPath)) {
-                    const files = fs.readdirSync(categoryPath).filter(f => f.endsWith('.md'));
-                    foundStandards.push(...files.map(f => `${category}/${f}`));
-                }
-            }
-            
-            if (foundStandards.length > 0) {
-                checks.standards.status = 'healthy';
-                checks.standards.details.push(`✅ 找到 ${foundStandards.length} 个规范文件`);
-                if (verbose) {
-                    foundStandards.slice(0, 5).forEach(s => {
-                        checks.standards.details.push(`  📄 ${s}`);
-                    });
-                    if (foundStandards.length > 5) {
-                        checks.standards.details.push(`  ... 还有 ${foundStandards.length - 5} 个文件`);
-                    }
-                }
-            } else {
-                checks.standards.status = 'warning';
-                checks.standards.details.push('⚠️  未找到规范文件');
-            }
-        } else {
-            checks.standards.status = 'error';
-            checks.standards.details.push('❌ standards 目录不存在');
-        }
-
-        // 生成总体健康状态
-        const allStatuses = Object.values(checks).map(c => c.status);
-        const overallStatus = allStatuses.includes('error') ? 'error' 
-                            : allStatuses.includes('warning') ? 'warning' 
-                            : 'healthy';
-
-        const statusEmoji = {
-            healthy: '✅',
-            warning: '⚠️',
-            error: '❌',
-            unknown: '❓'
-        };
-
-        logger.log(`${statusEmoji[overallStatus]} 健康检查完成`);
-
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    success: true,
-                    overallStatus,
-                    summary: `${statusEmoji[overallStatus]} MCP 服务器状态: ${overallStatus}`,
-                    checks,
-                    recommendations: generateRecommendations(checks)
-                }, null, 2)
-            }]
-        };
-    } catch (error) {
-        logger.error(`健康检查失败: ${error}`);
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    error: error instanceof Error ? error.message : String(error)
-                }, null, 2)
-            }]
-        };
-    }
-}
-
-/**
- * 根据检查结果生成建议
- */
-function generateRecommendations(checks: any): string[] {
-    const recommendations: string[] = [];
-    
-    if (checks.configuration.status !== 'healthy') {
-        recommendations.push('🔧 运行 auto_setup 工具自动配置 MCP 服务器');
-    }
-    
-    if (checks.workspace.status === 'error') {
-        recommendations.push('📁 确保在正确的工作区目录中运行');
-    }
-    
-    if (checks.dependencies.status === 'error') {
-        recommendations.push('📦 运行 npm install 安装依赖');
-    }
-    
-    if (checks.standards.status !== 'healthy') {
-        recommendations.push('📚 检查 standards 目录是否存在规范文件');
-    }
-    
-    if (recommendations.length === 0) {
-        recommendations.push('🎉 一切正常！您可以开始使用 MCP 服务器了');
-    }
-    
-    return recommendations;
-}

package/src/tools/listAgents.ts

@@ -1,91 +0,0 @@
-import { GitHubClient } from '../core/githubClient.js';
-import { ConsoleLogger } from '../core/types.js';
-
-/**
- * 列出所有可用的 Agents
- */
-export async function listAvailableAgents(): Promise<{
-    content: Array<{ type: string; text: string }>;
-}> {
-    const logger = new ConsoleLogger();
-    
-    try {
-        const githubClient = new GitHubClient(logger);
-        
-        logger.log('正在从 GitHub 获取 Agents 列表...');
-
-        const agentFiles = await githubClient.listDirectoryFiles('agents');
-        const agents = agentFiles.filter(f => f.name.endsWith('.agent.md'));
-
-        // 获取每个 Agent 的基本信息
-        const agentList = await Promise.all(
-            agents.map(async (file) => {
-                try {
-                    const content = await githubClient.fetchFileContent(file.path);
-                    
-                    // 简单解析标题和描述
-                    const lines = content.split('\n');
-                    let title = file.name.replace('.agent.md', '');
-                    let description = '';
-                    
-                    // 尝试从 frontmatter 提取
-                    if (lines[0] === '---') {
-                        const endIndex = lines.slice(1).findIndex(l => l === '---');
-                        if (endIndex > 0) {
-                            const frontmatter = lines.slice(1, endIndex + 1).join('\n');
-                            const descMatch = frontmatter.match(/description:\s*['"](.+)['"]/);
-                            if (descMatch) {
-                                description = descMatch[1];
-                            }
-                        }
-                    }
-                    
-                    // 提取标题（第一个 # 开头的行）
-                    const titleLine = lines.find(l => l.startsWith('# '));
-                    if (titleLine) {
-                        title = titleLine.replace('# ', '').trim();
-                    }
-
-                    return {
-                        id: file.name.replace('.agent.md', ''),
-                        name: file.name,
-                        title,
-                        description: description || '暂无描述',
-                        path: file.path
-                    };
-                } catch (error) {
-                    logger.error(`解析 ${file.name} 失败: ${error}`);
-                    return null;
-                }
-            })
-        );
-
-        const validAgents = agentList.filter(a => a !== null);
-
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    success: true,
-                    total: validAgents.length,
-                    agents: validAgents,
-                    categories: {
-                        general: validAgents.filter(a => a!.path.includes('common/')).length,
-                        frameworks: validAgents.filter(a => a!.path.includes('vue/') || a!.path.includes('react/')).length,
-                        agents: validAgents.filter(a => a!.path.includes('agents/')).length
-                    }
-                }, null, 2)
-            }]
-        };
-    } catch (error) {
-        logger.error(`获取 Agents 列表失败: ${error}`);
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    error: error instanceof Error ? error.message : String(error)
-                }, null, 2)
-            }]
-        };
-    }
-}

package/src/tools/matchAgents.ts

@@ -1,80 +0,0 @@
-import { GitHubClient } from '../core/githubClient.js';
-import { SmartAgentMatcher } from '../core/smartAgentMatcher.js';
-import { ProjectFeatures, AgentMetadata, ConsoleLogger } from '../core/types.js';
-
-/**
- * 匹配 Agents 工具
- */
-export async function matchAgents(args: {
-    projectFeatures: ProjectFeatures;
-    limit?: number;
-}): Promise<{
-    content: Array<{ type: string; text: string }>;
-}> {
-    const logger = new ConsoleLogger();
-    
-    try {
-        const matcher = new SmartAgentMatcher(logger);
-        const githubClient = new GitHubClient(logger);
-
-        logger.log('正在从 GitHub 获取可用 Agents...');
-
-        // 获取所有可用的 Agents
-        const availableAgents: AgentMetadata[] = [];
-        
-        try {
-            const agentFiles = await githubClient.listDirectoryFiles('agents');
-            
-            for (const file of agentFiles) {
-                if (file.name.endsWith('.agent.md')) {
-                    try {
-                        const content = await githubClient.fetchFileContent(file.path);
-                        const metadata = matcher.parseAgentMetadata(file.path, content);
-                        availableAgents.push(metadata);
-                    } catch (error) {
-                        logger.error(`解析 ${file.name} 失败: ${error}`);
-                    }
-                }
-            }
-        } catch (error) {
-            logger.error(`获取 Agents 失败: ${error}`);
-        }
-
-        // 匹配 Agents
-        const matchedAgents = matcher.matchAgents(args.projectFeatures, availableAgents);
-        
-        // 限制返回数量
-        const limit = args.limit || 10;
-        const topAgents = matchedAgents.slice(0, limit);
-
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    success: true,
-                    totalAvailable: availableAgents.length,
-                    matched: topAgents.length,
-                    agents: topAgents.map(agent => ({
-                        id: agent.id,
-                        title: agent.title,
-                        description: agent.description,
-                        score: agent.score,
-                        tags: agent.tags,
-                        path: agent.path
-                    })),
-                    recommendations: topAgents.slice(0, 5).map(a => a.title)
-                }, null, 2)
-            }]
-        };
-    } catch (error) {
-        logger.error(`匹配 Agents 失败: ${error}`);
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    error: error instanceof Error ? error.message : String(error)
-                }, null, 2)
-            }]
-        };
-    }
-}

package/src/tools/usePreset.ts

@@ -1,180 +0,0 @@
-import { StandardsManager } from '../core/standardsManager.js';
-import { ConsoleLogger } from '../core/types.js';
-
-/**
- * 预设场景定义
- */
-const PRESETS = {
-    'vue3-component': {
-        name: 'Vue 3 组件开发',
-        fileType: 'vue',
-        imports: ['vue', 'element-plus'],
-        scenario: '组件开发',
-        description: '开发 Vue 3 单文件组件，包含 Composition API 和 Element Plus'
-    },
-    'vue3-form': {
-        name: 'Vue 3 表单开发',
-        fileType: 'vue',
-        imports: ['vue', 'element-plus'],
-        scenario: '表单组件',
-        description: 'Element Plus 表单组件开发，包含验证和国际化'
-    },
-    'vue3-table': {
-        name: 'Vue 3 表格开发',
-        fileType: 'vue',
-        imports: ['vue', 'element-plus'],
-        scenario: '表格组件',
-        description: 'Element Plus 表格组件开发，包含分页和操作'
-    },
-    'pinia-store': {
-        name: 'Pinia 状态管理',
-        fileType: 'ts',
-        imports: ['vue', 'pinia'],
-        scenario: '状态管理',
-        description: 'Pinia store 定义，包含 actions、getters 和持久化'
-    },
-    'api-call': {
-        name: 'API 调用层',
-        fileType: 'ts',
-        imports: ['axios'],
-        scenario: 'API 调用',
-        description: 'RESTful API 调用封装，包含错误处理和类型定义'
-    },
-    'typescript-strict': {
-        name: 'TypeScript 严格模式',
-        fileType: 'ts',
-        imports: [],
-        scenario: '类型定义',
-        description: 'TypeScript 严格类型定义和类型守卫'
-    },
-    'i18n': {
-        name: '国际化开发',
-        fileType: 'vue',
-        imports: ['vue', 'vue-i18n'],
-        scenario: '国际化',
-        description: 'Vue I18n 多语言支持，包含翻译文件管理'
-    },
-    'composable': {
-        name: 'Vue 3 Composable',
-        fileType: 'ts',
-        imports: ['vue'],
-        scenario: '可组合函数',
-        description: 'Vue 3 组合式函数开发，复用逻辑'
-    }
-} as const;
-
-type PresetId = keyof typeof PRESETS;
-
-/**
- * 预设场景快捷工具
- * 使用预定义的场景配置快速获取规范
- */
-export async function usePreset(args: {
-    preset: string;
-    customImports?: string[];
-}): Promise<{
-    content: Array<{ type: string; text: string }>;
-}> {
-    const logger = new ConsoleLogger();
-    const manager = new StandardsManager();
-    
-    try {
-        // 验证预设
-        if (!(args.preset in PRESETS)) {
-            return {
-                content: [{
-                    type: 'text',
-                    text: JSON.stringify({
-                        error: `未知的预设: ${args.preset}`,
-                        availablePresets: Object.keys(PRESETS).map(id => ({
-                            id,
-                            name: PRESETS[id as PresetId].name,
-                            description: PRESETS[id as PresetId].description
-                        }))
-                    }, null, 2)
-                }]
-            };
-        }
-
-        const preset = PRESETS[args.preset as PresetId];
-        logger.log(`🎯 使用预设: ${preset.name}`);
-
-        // 合并自定义导入
-        const imports = args.customImports 
-            ? [...preset.imports, ...args.customImports]
-            : [...preset.imports];  // 创建新数组避免只读问题
-
-        // 获取相关规范
-        const standards = manager.getRelevantStandards({
-            fileType: preset.fileType,
-            imports: imports.length > 0 ? imports : undefined,
-            scenario: preset.scenario
-        });
-
-        const combinedContent = manager.combineStandards(standards);
-
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    success: true,
-                    preset: {
-                        id: args.preset,
-                        name: preset.name,
-                        description: preset.description
-                    },
-                    applied: {
-                        fileType: preset.fileType,
-                        imports,
-                        scenario: preset.scenario
-                    },
-                    standards: standards,
-                    content: combinedContent,
-                    stats: {
-                        standardsCount: standards.length,
-                        contentLength: combinedContent.length,
-                        estimatedTokens: Math.ceil(combinedContent.length / 4)
-                    }
-                }, null, 2)
-            }]
-        };
-    } catch (error) {
-        logger.error(`使用预设失败: ${error}`);
-        return {
-            content: [{
-                type: 'text',
-                text: JSON.stringify({
-                    error: error instanceof Error ? error.message : String(error)
-                }, null, 2)
-            }]
-        };
-    }
-}
-
-/**
- * 列出所有可用预设
- */
-export async function listPresets(): Promise<{
-    content: Array<{ type: string; text: string }>;
-}> {
-    const presetList = Object.entries(PRESETS).map(([id, preset]) => ({
-        id,
-        name: preset.name,
-        description: preset.description,
-        fileType: preset.fileType,
-        imports: preset.imports,
-        scenario: preset.scenario
-    }));
-
-    return {
-        content: [{
-            type: 'text',
-            text: JSON.stringify({
-                success: true,
-                total: presetList.length,
-                presets: presetList,
-                usage: '使用方式: 调用 use_preset 工具并指定 preset 参数'
-            }, null, 2)
-        }]
-    };
-}