mta-mcp 1.0.0

package/agents/vue3.agent.md

@@ -0,0 +1,176 @@
+# Vue 3 + TypeScript 开发代理
+
+> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
+> 版本: v3.0.0 | 最后更新: 2026-01-16
+
+---
+
+## 🔴 问题诊断优先（最高优先级）
+
+**当用户描述任何问题时，必须首先调用：**
+
+```
+troubleshoot({ problem: "用户描述的问题" })
+```
+
+案例库包含经过验证的解决方案，可避免无效尝试。
+
+---
+
+## 📚 规范获取指引
+
+**⚠️ 核心原则：写代码前，必须先通过 MCP 工具获取规范！**
+
+### 按文件类型获取
+
+| 场景 | MCP 调用 |
+|------|----------|
+| Vue 组件 | `get_standard_by_id({ id: 'vue3-composition' })` |
+| TypeScript | `get_standard_by_id({ id: 'typescript-base' })` |
+| Dart/Flutter | `get_standard_by_id({ id: 'flutter' })` |
+
+### 按使用的库获取
+
+| 库 | MCP 调用 |
+|----|----------|
+| Element Plus | `get_standard_by_id({ id: 'element-plus' })` |
+| Pinia | `get_standard_by_id({ id: 'pinia' })` |
+| Vue Router | `get_standard_by_id({ id: 'vue-router' })` |
+| vue-i18n | `get_standard_by_id({ id: 'i18n' })` |
+| LogicFlow | `get_standard_by_id({ id: 'logicflow' })` |
+
+### 按场景获取
+
+| 场景 | MCP 调用 |
+|------|----------|
+| CSS 样式 | `get_standard_by_id({ id: 'vue-css-nesting' })` |
+| API 调用 | `get_standard_by_id({ id: 'api-layer' })` |
+| 代码风格 | `get_standard_by_id({ id: 'code-style' })` |
+
+### 智能获取（推荐）
+
+```
+// 根据当前文件自动匹配规范
+get_compact_standards({ currentFile: "当前文件路径" })
+
+// 获取多个规范
+get_standard_by_id({ ids: ['vue3-composition', 'element-plus', 'i18n'] })
+```
+
+---
+
+## 🎯 Vue 3 快速提示
+
+> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+
+### 必须遵守
+
+- ✅ 使用 Composition API (`<script setup lang="ts">`)
+- ✅ Props/Emits 必须定义 TypeScript 类型
+- ✅ 所有用户可见文本必须国际化 `$t('...')`
+- ✅ 单文件组件只能有一个 `<style>` 标签
+
+### 禁止
+
+- ❌ 使用 `any` 类型
+- ❌ 使用 Options API
+- ❌ 硬编码文本（必须用 `$t()`）
+- ❌ 多个 `<style>` 标签
+
+### Element Plus 单行书写（如项目要求）
+
+```vue
+<!-- ✅ 正确 -->
+<el-table v-loading="loading" :data="list" border highlight-current-row>
+
+<!-- ❌ 错误 -->
+<el-table 
+  v-loading="loading" 
+  :data="list">
+```
+
+---
+
+## 🔧 标准工作流
+
+```
+1. 用户提出需求
+   ↓
+2. 检查是否是问题描述 → 是 → 调用 troubleshoot()
+   ↓ 否
+3. 识别需要的规范类型（Vue/Element Plus/Pinia 等）
+   ↓
+4. 调用对应的 get_standard_by_id() 获取详细规范
+   ↓
+5. 根据获取的规范编写代码
+   ↓
+6. 验证代码符合规范
+```
+
+---
+
+## 📋 可用规范列表
+
+通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+
+**核心规范**
+- `mandatory-rules` - 底层必须规则（自动注入）
+- `code-style` - 代码风格规范
+- `typescript-base` - TypeScript 基础规范
+- `code-generation` - 代码生成规范
+
+**框架规范**
+- `vue3-composition` - Vue 3 Composition API
+- `pinia` - Pinia 状态管理
+- `flutter` - Flutter 开发规范
+
+**库规范**
+- `element-plus` - Element Plus 组件库
+- `i18n` - 国际化规范
+- `logicflow` - LogicFlow 流程图
+
+**模式规范**
+- `vue-css-nesting` - Vue CSS 嵌套写法
+- `api-layer` - API 层封装模式
+- `design-tokens` - 设计 Token 系统
+
+---
+
+## 🎨 设计稿还原强制规范（跨平台通用）
+
+> ⚠️ 还原 Sketch/Figma 设计稿时必须遵守
+
+### 🔴 全局样式优先（最高优先级）
+
+**在还原任何 UI 前，必须首先检查项目是否存在全局样式规范！**
+
+#### 检查顺序
+
+1. **检查项目设计 Token** - 如 `design_constants.dart`、`design-tokens.ts`
+2. **优先使用语义化常量** - 而非硬编码数值
+3. **颜色/圆角/阴影/间距** - 必须使用全局定义
+
+#### 常见样式对照表
+
+| 类型 | 常见值 | 应使用 |
+|------|--------|--------|
+| **圆角** | 16px | `$radius.lg` / CSS 变量 `--radius-lg` |
+| **圆角** | 12px | `$radius.base` |
+| **圆角** | 8px | `$radius.xs` |
+| **按钮高度** | 56px | `$button.heightCTA` |
+| **按钮高度** | 40px | `$button.heightMedium` |
+| **按钮高度** | 32px | `$button.heightSmall` |
+| **阴影** | 拟物卡片 | `$shadow.card` |
+| **主色** | 红色CTA | `$color.primary` |
+| **文字色** | 深色 | `$color.textPrimary` |
+
+#### 禁止事项
+- ❌ 硬编码 `border-radius: 16px` - 应使用 CSS 变量或常量
+- ❌ 硬编码 `height: 56px` - 应使用按钮尺寸常量
+- ❌ 硬编码 `color: #1C2B45` - 应使用颜色变量
+- ❌ 手写 `box-shadow` - 应使用预设阴影 mixin
+
+---
+
+**维护团队**: MTA工作室  
+**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/agents/wechat-miniprogram.agent.md

@@ -0,0 +1,89 @@
+# 微信小程序开发代理
+
+> 此 Agent 引导 AI 通过 MCP 工具获取 npm 包中的详细规范
+> 版本: v3.0.0 | 最后更新: 2026-01-16
+
+---
+
+## 🔴 问题诊断优先（最高优先级）
+
+**当用户描述任何问题时，必须首先调用：**
+
+```
+troubleshoot({ problem: "用户描述的问题" })
+```
+
+---
+
+## 📚 规范获取指引
+
+**⚠️ 核心原则：开发小程序代码前，必须先获取规范！**
+
+### 按场景获取
+
+| 场景 | MCP 调用 |
+|------|----------|
+| 页面开发 | `get_standard_by_id({ id: 'wechat-miniprogram' })` |
+| 组件开发 | `get_standard_by_id({ id: 'wechat-miniprogram' })` |
+| 网络请求 | `get_standard_by_id({ id: 'wechat-miniprogram' })` |
+| 云开发 | `get_standard_by_id({ id: 'wechat-cloud' })` |
+
+### 智能获取（推荐）
+
+```
+// 根据当前文件自动匹配
+get_compact_standards({ 
+  currentFile: "pages/index/index.js",
+  imports: ["wx"]
+})
+```
+
+---
+
+## 🎯 快速提示
+
+> 以下是简要提示，**详细规范请通过上述 MCP 工具获取**
+
+### 目录结构
+
+```
+miniprogram/
+├── app.js / app.json / app.wxss
+├── pages/          # 页面目录
+├── components/     # 组件目录
+├── utils/          # 工具函数
+├── api/            # API 管理
+└── config/         # 配置文件
+```
+
+### 必须遵守
+
+- ✅ 使用 Component 构建自定义组件
+- ✅ 合理使用 setData（避免频繁调用）
+- ✅ 异步操作使用 Promise 封装
+- ✅ 遵循小程序生命周期
+
+### 禁止
+
+- ❌ 直接操作 DOM
+- ❌ 同步阻塞操作
+- ❌ setData 传递大量数据
+- ❌ 未处理的 Promise reject
+
+---
+
+## 📋 可用规范列表
+
+通过 `get_standard_by_id({ id: 'xxx' })` 获取：
+
+**核心规范**
+- `wechat-miniprogram` - 小程序完整开发规范
+
+**配套规范**
+- `api-layer` - API 层封装模式
+- `component-design` - 组件设计模式
+
+---
+
+**维护团队**: MTA工作室  
+**设计理念**: Agent 只提供获取指引，详细规范由 MCP 工具从 npm 包动态获取

package/bin/mta.cjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+
+/**
+ * MTA MCP Server 入口
+ * 最低要求: Node.js 16+ (由 @modelcontextprotocol/sdk 决定)
+ */
+
+const { existsSync, readdirSync, readFileSync } = require('fs');
+const { join } = require('path');
+const { pathToFileURL } = require('url');
+
+// 检测 Node.js 版本
+const nodeVersion = process.versions.node;
+const majorVersion = parseInt(nodeVersion.split('.')[0]);
+
+// 最低版本检查
+if (majorVersion < 16) {
+  console.error(`[MCP Error] Node.js 版本过低: v${nodeVersion}`);
+  console.error('[MCP Error] mta-mcp 需要 Node.js 16.0.0 或更高版本');
+  console.error('[MCP Error] 请升级 Node.js: https://nodejs.org/');
+  process.exit(1);
+}
+
+// 获取包根目录
+const packageRoot = join(__dirname, '..');
+
+// 处理 CLI 参数
+const args = process.argv.slice(2);
+
+// --get-agent <id>: 获取指定 Agent 的完整内容
+const getAgentIndex = args.indexOf('--get-agent');
+if (getAgentIndex !== -1) {
+  const agentId = args[getAgentIndex + 1];
+  
+  if (!agentId) {
+    console.log(JSON.stringify({ error: '请提供 Agent ID', content: null }));
+    process.exit(1);
+  }
+  
+  const agentsDir = join(packageRoot, 'agents');
+  const agentFile = join(agentsDir, `${agentId}.agent.md`);
+  
+  if (!existsSync(agentFile)) {
+    console.log(JSON.stringify({ error: `Agent 不存在: ${agentId}`, content: null }));
+    process.exit(1);
+  }
+  
+  try {
+    const content = readFileSync(agentFile, 'utf-8');
+    console.log(JSON.stringify({ content }));
+  } catch (e) {
+    console.log(JSON.stringify({ error: `读取 Agent 失败: ${e.message}`, content: null }));
+    process.exit(1);
+  }
+  
+  process.exit(0);
+}
+
+// --list-agents: 列出所有可用的 Agents
+if (args.includes('--list-agents')) {
+  const agentsDir = join(packageRoot, 'agents');
+  
+  if (!existsSync(agentsDir)) {
+    console.error(JSON.stringify({ error: 'Agents 目录不存在', agents: [] }));
+    process.exit(1);
+  }
+  
+  const agents = [];
+  const files = readdirSync(agentsDir).filter(f => f.endsWith('.agent.md') && !f.endsWith('.bak'));
+  
+  for (const file of files) {
+    try {
+      const content = readFileSync(join(agentsDir, file), 'utf-8');
+      const lines = content.split('\n');
+      
+      // 提取 ID
+      const id = file.replace('.agent.md', '');
+      
+      // 提取标题
+      let title = id;
+      const titleLine = lines.find(l => l.trim().startsWith('# '));
+      if (titleLine) {
+        title = titleLine.replace(/^#\s*/, '').trim();
+      }
+      
+      // 提取描述
+      let description = '暂无描述';
+      const descLine = lines.find(l => l.trim().startsWith('> '));
+      if (descLine) {
+        description = descLine.replace(/^>\s*/, '').trim();
+      }
+      
+      // 提取标签
+      const tags = [];
+      const tagsLine = lines.find(l => 
+        l.includes('**标签**') || 
+        l.includes('**关键词**') ||
+        l.includes('**Tags**')
+      );
+      if (tagsLine) {
+        const tagsMatch = tagsLine.match(/[:：]\s*(.+)/);
+        if (tagsMatch) {
+          tags.push(...tagsMatch[1].split(/[,，、]/).map(t => t.trim()));
+        }
+      }
+      
+      agents.push({ id, title, description, tags });
+    } catch (e) {
+      // 忽略解析失败的文件
+    }
+  }
+  
+  // 输出 JSON
+  console.log(JSON.stringify({ agents }, null, 2));
+  process.exit(0);
+}
+
+// 默认行为：启动 MCP 服务器
+const esmPath = join(packageRoot, 'dist', 'index.js');
+
+if (!existsSync(esmPath)) {
+  console.error(`[MCP Error] 未找到构建版本: ${esmPath}`);
+  console.error('[MCP Error] 请确保已运行: npm run build');
+  process.exit(1);
+}
+
+// 加载 ES Module - 在 Windows 上必须转换为 file:// URL
+const esmUrl = pathToFileURL(esmPath).href;
+import(esmUrl).catch(err => {
+  console.error('[MCP Error] 启动失败:', err.message);
+  process.exit(1);
+});