mta-mcp 1.9.0 → 2.2.0

package/build/tools/queryMappings.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 查询场景-规范映射工具
+ *
+ * 设计理念：提供映射信息给 AI，让 AI 自己决定使用哪些规范
+ * 不做"智能推荐"，只提供数据查询
+ *
+ * @module tools/queryMappings
+ */
+/**
+ * 查询场景-规范映射
+ *
+ * 这个工具只返回映射关系，不做任何"智能"处理
+ * AI 可以参考这些映射自己做决策
+ *
+ * @example
+ * // 查询特定场景的规范
+ * query_mappings({ scenario: 'vue3-form' })
+ *
+ * @example
+ * // 查询文件类型对应的规范
+ * query_mappings({ fileType: 'vue' })
+ *
+ * @example
+ * // 查询导入包对应的规范
+ * query_mappings({ imports: ['element-plus', 'pinia'] })
+ *
+ * @example
+ * // 获取所有映射关系
+ * query_mappings({ listAll: true })
+ */
+export declare function queryMappings(args: {
+    /** 场景名称 */
+    scenario?: string;
+    /** 文件类型 */
+    fileType?: string;
+    /** 导入的包 */
+    imports?: string[];
+    /** 列出所有映射 */
+    listAll?: boolean;
+}): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/**
+ * 获取可用场景列表
+ */
+export declare function listScenarios(): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=queryMappings.d.ts.map

package/build/tools/queryMappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryMappings.d.ts","sourceRoot":"","sources":["../../src/tools/queryMappings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACtC,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC;IACR,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD,CAAC,CA6ED;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAC3C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD,CAAC,CAWD"}

package/build/tools/queryMappings.js

@@ -0,0 +1,119 @@
+/**
+ * 查询场景-规范映射工具
+ *
+ * 设计理念：提供映射信息给 AI，让 AI 自己决定使用哪些规范
+ * 不做"智能推荐"，只提供数据查询
+ *
+ * @module tools/queryMappings
+ */
+import { SCENARIO_STANDARDS, FILETYPE_STANDARDS, IMPORT_STANDARDS, suggestStandards, listAvailableScenarios } from '../core/mappings/scenarioMappings.js';
+import { ConsoleLogger } from '../core/types.js';
+/**
+ * 查询场景-规范映射
+ *
+ * 这个工具只返回映射关系，不做任何"智能"处理
+ * AI 可以参考这些映射自己做决策
+ *
+ * @example
+ * // 查询特定场景的规范
+ * query_mappings({ scenario: 'vue3-form' })
+ *
+ * @example
+ * // 查询文件类型对应的规范
+ * query_mappings({ fileType: 'vue' })
+ *
+ * @example
+ * // 查询导入包对应的规范
+ * query_mappings({ imports: ['element-plus', 'pinia'] })
+ *
+ * @example
+ * // 获取所有映射关系
+ * query_mappings({ listAll: true })
+ */
+export async function queryMappings(args) {
+    const logger = new ConsoleLogger();
+    try {
+        // 如果请求列出所有映射
+        if (args.listAll) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            description: '场景-规范映射表，AI 可参考这些映射自行决定使用哪些规范',
+                            mappings: {
+                                scenarios: SCENARIO_STANDARDS,
+                                fileTypes: FILETYPE_STANDARDS,
+                                imports: IMPORT_STANDARDS
+                            },
+                            availableScenarios: listAvailableScenarios()
+                        }, null, 2)
+                    }]
+            };
+        }
+        // 查询特定映射
+        const result = {
+            success: true,
+            query: {},
+            suggestions: []
+        };
+        if (args.scenario) {
+            result.query.scenario = args.scenario;
+            result.scenarioStandards = SCENARIO_STANDARDS[args.scenario] || [];
+        }
+        if (args.fileType) {
+            result.query.fileType = args.fileType;
+            result.fileTypeStandards = FILETYPE_STANDARDS[args.fileType] || [];
+        }
+        if (args.imports && args.imports.length > 0) {
+            result.query.imports = args.imports;
+            result.importStandards = {};
+            for (const imp of args.imports) {
+                const normalizedImport = imp.startsWith('@')
+                    ? imp.split('/').slice(0, 2).join('/')
+                    : imp.split('/')[0];
+                result.importStandards[imp] = IMPORT_STANDARDS[normalizedImport] || [];
+            }
+        }
+        // 汇总建议（去重）
+        result.suggestions = suggestStandards({
+            scenario: args.scenario,
+            fileType: args.fileType,
+            imports: args.imports
+        });
+        result.note = 'AI 可根据具体情况选择使用哪些规范，这只是建议列表';
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, 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 listScenarios() {
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    scenarios: listAvailableScenarios(),
+                    description: 'AI 可使用这些场景名称调用 use_preset 或 query_mappings'
+                }, null, 2)
+            }]
+    };
+}
+//# sourceMappingURL=queryMappings.js.map

package/build/tools/queryMappings.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mta-mcp",
-  "version": "1.9.0",
-  "description": "MTA - 智能项目分析与编码规范管理 MCP 服务器（v1.9.0: 首次使用自动配置）",
+  "version": "2.2.0",
+  "description": "MTA - 智能项目分析与编码规范管理 MCP 服务器，为 GitHub Copilot 和 Claude 提供项目分析、规范匹配、模板管理功能",
   "type": "module",
   "main": "build/index.js",
   "bin": {
@@ -9,10 +9,11 @@
   },
   "files": [
     "build/",
-    "src/",
     "standards/",
     "agents/",
-    "common/"
+    "common/",
+    "templates/",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc",
@@ -20,18 +21,32 @@
     "start": "node build/index.js",
     "dev": "tsc --watch",
     "prepare": "npm run build",
-    "clean": "rm -rf build"
+    "clean": "rm -rf build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
   },
   "keywords": [
     "mcp",
+    "model-context-protocol",
     "copilot",
+    "github-copilot",
+    "claude",
     "ai",
     "agents",
-    "github",
-    "claude"
+    "coding-standards",
+    "project-analysis",
+    "typescript",
+    "vue",
+    "react"
   ],
   "author": "ForLear",
   "license": "MIT",
+  "homepage": "https://github.com/ForLear/copilot-prompts#readme",
+  "bugs": {
+    "url": "https://github.com/ForLear/copilot-prompts/issues"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.3",
     "axios": "^1.6.5",
@@ -39,7 +54,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.11.0",
-    "typescript": "^5.3.3"
+    "@vitest/coverage-v8": "^4.0.16",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.16"
   },
   "engines": {
     "node": ">=18.0.0"

package/src/core/autoInitializer.ts

@@ -1,170 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { analyzeProject } from '../tools/analyzeProject.js';
-import { generateConfig } from '../tools/generateConfig.js';
-import { Logger } from './types.js';
-
-/**
- * 自动初始化器
- * 在工具调用前检查项目配置，如果不存在则自动生成
- */
-export class AutoInitializer {
-    private initialized: Map<string, boolean> = new Map();
-    
-    constructor(private logger?: Logger) {}
-
-    /**
-     * 检查并初始化项目配置
-     * @param workspacePath 工作区路径
-     * @returns 是否需要初始化（返回 true 表示已执行初始化）
-     */
-    async ensureProjectConfig(workspacePath?: string): Promise<{
-        needsInit: boolean;
-        initialized: boolean;
-        message: string;
-    }> {
-        // 检测工作区路径
-        const projectPath = workspacePath || this.detectWorkspacePath();
-        
-        if (!projectPath) {
-            return {
-                needsInit: false,
-                initialized: false,
-                message: '未检测到工作区路径'
-            };
-        }
-
-        // 检查是否已经初始化过（避免重复）
-        if (this.initialized.get(projectPath)) {
-            return {
-                needsInit: false,
-                initialized: true,
-                message: `项目已配置: ${path.basename(projectPath)}`
-            };
-        }
-
-        // 检查是否存在配置文件
-        const configPath = path.join(projectPath, '.github', 'copilot-instructions.md');
-        const hasConfig = fs.existsSync(configPath);
-
-        if (hasConfig) {
-            this.initialized.set(projectPath, true);
-            return {
-                needsInit: false,
-                initialized: true,
-                message: `项目已有配置: ${path.basename(projectPath)}`
-            };
-        }
-
-        // 需要初始化
-        this.log(`🔍 检测到项目未配置，开始自动分析和生成配置...`);
-        this.log(`📁 项目路径: ${projectPath}`);
-
-        try {
-            // 1. 分析项目
-            this.log('1️⃣ 分析项目技术栈...');
-            const analysisResult = await analyzeProject({ projectPath });
-            
-            if (analysisResult.content?.[0]?.text) {
-                const analysis = JSON.parse(analysisResult.content[0].text);
-                this.log(`✅ 检测到: ${analysis.frameworks?.join(', ') || '未知技术栈'}`);
-
-                // 2. 生成配置
-                this.log('2️⃣ 生成项目配置文件...');
-                await generateConfig({
-                    projectPath,
-                    autoMatch: true
-                });
-
-                this.initialized.set(projectPath, true);
-
-                return {
-                    needsInit: true,
-                    initialized: true,
-                    message: `✅ 项目配置已自动生成\n📁 路径: ${configPath}\n🎯 技术栈: ${analysis.frameworks?.join(', ')}`
-                };
-            }
-        } catch (error) {
-            this.log(`❌ 自动初始化失败: ${error}`);
-            return {
-                needsInit: true,
-                initialized: false,
-                message: `⚠️ 自动初始化失败: ${error instanceof Error ? error.message : String(error)}`
-            };
-        }
-
-        return {
-            needsInit: true,
-            initialized: false,
-            message: '⚠️ 无法完成自动初始化'
-        };
-    }
-
-    /**
-     * 检测工作区路径
-     */
-    private detectWorkspacePath(): string | null {
-        // 优先级 1: 环境变量
-        if (process.env.WORKSPACE_PATH) {
-            return process.env.WORKSPACE_PATH;
-        }
-
-        // 优先级 2: 当前工作目录
-        const cwd = process.cwd();
-        if (this.isValidProject(cwd)) {
-            return cwd;
-        }
-
-        // 优先级 3: 尝试从常见位置检测
-        const possiblePaths = [
-            path.join(cwd, '..'),
-            path.join(cwd, '../..'),
-        ];
-
-        for (const possiblePath of possiblePaths) {
-            if (this.isValidProject(possiblePath)) {
-                return possiblePath;
-            }
-        }
-
-        return null;
-    }
-
-    /**
-     * 判断是否是有效的项目目录
-     */
-    private isValidProject(dirPath: string): boolean {
-        if (!fs.existsSync(dirPath)) {
-            return false;
-        }
-
-        // 检查是否有项目标志文件
-        const markers = [
-            'package.json',
-            'pubspec.yaml',
-            'pom.xml',
-            'go.mod',
-            'Cargo.toml',
-            '.git'
-        ];
-
-        return markers.some(marker => 
-            fs.existsSync(path.join(dirPath, marker))
-        );
-    }
-
-    /**
-     * 重置初始化状态（用于测试）
-     */
-    reset(): void {
-        this.initialized.clear();
-    }
-
-    private log(message: string): void {
-        if (this.logger) {
-            this.logger.log(message);
-        } else {
-            console.error(`[AutoInit] ${message}`);
-        }
-    }
-}