mta-mcp 1.9.1 → 2.3.0

package/README.md

@@ -1,11 +1,25 @@
 # Copilot Prompts MCP Server
 
-[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)
+[![MCP](https://img.shields.io/badge/MCP-2.0-blue)](https://modelcontextprotocol.io)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
 智能分析项目并自动匹配 GitHub Copilot Agents 的 MCP 服务器。
 
+## 🧠 v2.0 设计理念
+
+> **MCP = 信息提供者，AI = 决策者**
+
+v2.0 版本进行了重大设计调整：
+
+| 错误做法 | 正确做法 |
+|---------|---------|
+| MCP 分析意图 → 计算权重 → 匹配规范 | AI 知道需要什么 → 调用 MCP → MCP 快速返回数据 |
+| MCP 返回"推荐规范" | MCP 返回"可用信息供参考" |
+| 复杂的权重算法 | 简单的映射表查询 |
+
+**核心思想**：AI 比 MCP 更擅长理解用户意图和做决策，MCP 只需要提供高效的数据访问能力。
+
 ## 🎯 功能特性
 
 ### 核心功能
@@ -15,7 +29,12 @@
 - **模块化编码规范** - MCP Resources 按需加载，节省 50-70% tokens
 - **跨平台支持** - 可用于 Claude Desktop、VS Code 等任何 MCP 客户端
 
-### Phase 4: 傻瓜模式 🎉 NEW
+### v2.0 新增：直接访问工具 🆕
+- **📖 `get_standard_by_id`** - AI 知道需要什么规范时，直接按 ID 获取
+- **🗺️ `query_mappings`** - 查询场景-规范映射关系，AI 自行决策
+- **📋 `list_scenarios`** - 列出所有可用场景名称
+
+### Phase 4: 傻瓜模式 🎉
 - **🎯 一键自动配置** - `auto_setup` 工具，30 秒完成 VS Code 配置
 - **🏥 健康检查诊断** - `health_check` 工具，自动诊断并给出修复建议
 - **🧠 零参数智能推荐** - `get_smart_standards` 工具，自动检测上下文
@@ -84,6 +103,125 @@ Claude: [调用 generate_config 工具]
 
 ## 🛠️ 可用工具
 
+### 📖 v2.0 直接访问工具（推荐 AI 使用）
+
+> 这些工具遵循"MCP = 信息提供者"理念，AI 直接调用获取需要的数据。
+
+#### 1. `get_standard_by_id` - 按 ID 直接获取规范 ⭐
+
+AI 知道需要什么规范时，直接按 ID 获取，最简洁高效。
+
+**参数**:
+```typescript
+{
+  id?: string,              // 单个规范 ID
+  ids?: string[],           // 多个规范 ID（批量获取）
+  mode?: 'summary' | 'key-rules' | 'full'  // 加载模式，默认 key-rules
+}
+```
+
+**使用示例**:
+```
+// 获取单个规范
+get_standard_by_id({ id: 'vue3-composition', mode: 'key-rules' })
+
+// 批量获取
+get_standard_by_id({ ids: ['vue3-composition', 'element-plus'], mode: 'summary' })
+```
+
+#### 2. `query_mappings` - 查询场景-规范映射
+
+提供映射信息给 AI 参考，AI 自己决定使用哪些规范。
+
+**参数**:
+```typescript
+{
+  scenario?: string,    // 场景名称
+  fileType?: string,    // 文件类型
+  imports?: string[],   // 导入的包
+  listAll?: boolean     // 列出所有映射
+}
+```
+
+**使用示例**:
+```
+// 查询场景对应的规范
+query_mappings({ scenario: 'vue3-form' })
+
+// 查询所有映射关系
+query_mappings({ listAll: true })
+```
+
+#### 3. `list_scenarios` - 列出所有场景
+
+获取所有可用场景名称，用于 `use_preset` 或 `query_mappings`。
+
+**参数**: 无
+
+---
+
+### 📦 v2.1 模板系统工具
+
+> 模板是可复用的代码片段，AI 可根据需要选择并应用到目标项目。
+
+#### 1. `list_templates` - 列出可用模板
+
+列出所有可用的代码模板，支持按类型、框架筛选。
+
+**参数**:
+```typescript
+{
+  type?: 'api-layer' | 'component' | 'store' | 'composable' | 'config' | 'types',
+  framework?: string,    // 如 'vue', 'react'
+  search?: string        // 搜索关键词
+}
+```
+
+**使用示例**:
+```
+// 列出所有模板
+list_templates({})
+
+// 按类型筛选
+list_templates({ type: 'api-layer' })
+
+// 搜索
+list_templates({ search: 'axios' })
+```
+
+#### 2. `get_template` - 获取模板详情
+
+获取模板的配置说明和文件内容，AI 可根据说明自行修改并应用。
+
+**参数**:
+```typescript
+{
+  id: string,              // 模板 ID（如 'vue/api-layer'）
+  includeFiles?: boolean,  // 是否包含文件内容（默认 false）
+  files?: string[]         // 指定获取的文件列表（可选）
+}
+```
+
+**使用示例**:
+```
+// 获取配置说明（节省 token）
+get_template({ id: 'vue/api-layer' })
+
+// 获取完整模板（含所有文件）
+get_template({ id: 'vue/api-layer', includeFiles: true })
+
+// 获取特定文件
+get_template({ id: 'vue/api-layer', files: ['request.ts'] })
+```
+
+**AI 工作流**:
+1. 调用 `list_templates` 了解可用模板
+2. 调用 `get_template` 获取模板配置说明
+3. 根据目标项目情况决定如何修改模板
+4. 将模板文件复制到目标项目并适配
+
+---
+
 ### 🎯 Phase 4: 傻瓜模式工具（推荐）
 
 #### 1. `auto_setup` - 一键自动配置 ⭐

package/bin/mta.cjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+/**
+ * MTA MCP Server - 自动兼容 CommonJS 和 ES Module
+ * 根据当前 Node.js 版本自动选择合适的模块格式
+ */
+
+const { existsSync } = require('fs');
+const { join, dirname } = require('path');
+
+// 检测 Node.js 版本
+const nodeVersion = process.versions.node;
+const majorVersion = parseInt(nodeVersion.split('.')[0]);
+
+// 获取包根目录（bin 的上一级）
+const packageRoot = join(__dirname, '..');
+const distPath = join(packageRoot, 'dist');
+
+// Node.js 12-13 只支持 CommonJS
+if (majorVersion < 14) {
+  const cjsPath = join(distPath, 'index.cjs');
+  if (existsSync(cjsPath)) {
+    require(cjsPath);
+  } else {
+    console.error(`[MCP Error] 未找到 CommonJS 构建版本: ${cjsPath}`);
+    console.error('[MCP Error] 请确保已运行: npm run build');
+    process.exit(1);
+  }
+} else {
+  // Node.js 14+ 支持 ES Module
+  const esmPath = join(distPath, 'index.js');
+  if (existsSync(esmPath)) {
+    // 使用动态 import 加载 ES Module
+    import(esmPath).catch(err => {
+      console.error('[MCP Error] 启动失败:', err.message);
+      process.exit(1);
+    });
+  } else {
+    console.error(`[MCP Error] 未找到 ES Module 构建版本: ${esmPath}`);
+    console.error('[MCP Error] 请确保已运行: npm run build');
+    process.exit(1);
+  }
+}