mcp-probe-kit 3.0.19 → 3.0.22

package/build/utils/vercel-guidelines-sync.js

@@ -0,0 +1,133 @@
+/**
+ * Vercel Web Interface Guidelines → 可搜索 JSON
+ * @see https://github.com/vercel-labs/web-interface-guidelines
+ */
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { fetchText } from './shadcn-sync.js';
+export const VERCEL_GUIDELINES_URL = 'https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/AGENTS.md';
+export const VERCEL_GUIDELINES_VERSION = '2026-04-06';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const FALLBACK_PATH = path.join(process.cwd(), 'scripts', 'data', 'vercel-web-interface-guidelines.md');
+const BUNDLED_FALLBACK_PATH = path.join(__dirname, '..', '..', 'scripts', 'data', 'vercel-web-interface-guidelines.md');
+function computeChecksum(content) {
+    return crypto.createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 48);
+}
+function inferTags(rule, section) {
+    const text = `${section} ${rule}`.toLowerCase();
+    const tags = new Set(['vercel', 'web-interface']);
+    const keywords = [
+        'keyboard',
+        'focus',
+        'form',
+        'animation',
+        'accessibility',
+        'a11y',
+        'contrast',
+        'dark',
+        'performance',
+        'touch',
+        'navigation',
+        'aria',
+        'mobile',
+        'layout',
+        'hydration',
+    ];
+    for (const keyword of keywords) {
+        if (text.includes(keyword)) {
+            tags.add(keyword);
+        }
+    }
+    return Array.from(tags);
+}
+export function parseVercelGuidelinesMarkdown(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    let section = 'General';
+    let subsection = 'General';
+    const records = [];
+    let index = 0;
+    for (const line of lines) {
+        if (line.startsWith('## ')) {
+            section = line.slice(3).trim();
+            subsection = section;
+            continue;
+        }
+        if (line.startsWith('### ')) {
+            subsection = line.slice(4).trim();
+            continue;
+        }
+        const match = line.match(/^-\s+(MUST|SHOULD|NEVER):\s+(.+)$/);
+        if (!match) {
+            continue;
+        }
+        index += 1;
+        const level = match[1];
+        const rule = match[2].trim();
+        const id = `vercel-${slugify(section)}-${slugify(subsection)}-${index}`;
+        records.push({
+            id,
+            title: `${level}: ${rule.slice(0, 80)}${rule.length > 80 ? '…' : ''}`,
+            section,
+            subsection,
+            level,
+            rule,
+            description: rule,
+            category: 'ui-guidelines-vercel',
+            source: 'vercel-labs/web-interface-guidelines',
+            tags: inferTags(rule, section),
+        });
+    }
+    return records;
+}
+async function loadGuidelinesMarkdown(signal) {
+    try {
+        const text = await fetchText(VERCEL_GUIDELINES_URL, signal);
+        if (text.includes('MUST:')) {
+            return text;
+        }
+    }
+    catch {
+        // fallback below
+    }
+    for (const candidate of [FALLBACK_PATH, BUNDLED_FALLBACK_PATH]) {
+        if (fs.existsSync(candidate)) {
+            return fs.readFileSync(candidate, 'utf-8');
+        }
+    }
+    throw new Error('Vercel Web Interface Guidelines fallback file not found');
+}
+export async function syncVercelGuidelinesTo(outputDir, options) {
+    const markdown = await loadGuidelinesMarkdown(options?.signal);
+    const checksum = computeChecksum(markdown);
+    if (!options?.force && options?.existingChecksum === checksum) {
+        return null;
+    }
+    const records = parseVercelGuidelinesMarkdown(markdown);
+    const guidelinesDir = path.join(outputDir, 'guidelines');
+    if (!fs.existsSync(guidelinesDir)) {
+        fs.mkdirSync(guidelinesDir, { recursive: true });
+    }
+    fs.writeFileSync(path.join(guidelinesDir, 'vercel-web-interface.json'), `${JSON.stringify(records, null, 2)}\n`, 'utf-8');
+    return {
+        metadata: {
+            version: VERCEL_GUIDELINES_VERSION,
+            syncedAt: new Date().toISOString(),
+            checksum,
+        },
+        count: records.length,
+    };
+}
+export async function getVercelGuidelinesChecksum(signal) {
+    const markdown = await loadGuidelinesMarkdown(signal);
+    return computeChecksum(markdown);
+}

package/docs/data/tools.js

@@ -402,6 +402,24 @@ verbose: true`
     }
   ],
   memory: [
+    {
+      name: 'search_memory',
+      description: '按语义检索共享记忆库，支持 type/tags 优先排序',
+      schema: 'MemorySearchSchema',
+      params: [
+        { name: 'query', type: 'string', required: true, desc: '检索关键词或问题描述' },
+        { name: 'type', type: 'string', required: false, desc: '优先匹配的类型，如 bugfix' },
+        { name: 'tags', type: 'array', required: false, desc: '优先匹配的标签' },
+        { name: 'limit', type: 'number', required: false, desc: '返回条数' }
+      ],
+      usage: '在 start_* 之外主动查找历史 Bug 修复或可复用模式',
+      example: `// 使用示例
+你: 请使用 search_memory 搜索 proxy 相关 bugfix
+
+query: "proxy 400 HTTPS"
+type: "bugfix"
+limit: 5`
+    },
     {
       name: 'read_memory_asset',
       description: '按 asset_id 读取已存储 memory 资产的完整内容和元数据',

package/docs/i18n/all-tools/en.json

@@ -41,6 +41,7 @@
     "ui_design_system": "Design System",
     "ui_search": "Search UI",
     "code_insight": "Code Insight",
+    "search_memory": "Search Memory",
     "read_memory_asset": "Read Memory",
     "memorize_asset": "Store Memory",
     "scan_and_extract_patterns": "Extract Patterns",
@@ -75,7 +76,7 @@
     },
     "memory": {
       "title": "Memory & Cursor History",
-      "count": "6 tools"
+      "count": "7 tools"
     }
   },
   "toolsData": {
@@ -167,6 +168,10 @@
       "description": "Code graph insight tool, bridging GitNexus to analyze call chains, context, and impact (auto-degrades when unavailable)",
       "usage": "Refresh the GitNexus index, perform task-level call-chain/context/impact analysis, and persist results to docs/graph-insights plus the project-context index"
     },
+    "search_memory": {
+      "description": "Semantic search across the shared memory pool, with optional type/tags preference",
+      "usage": "Use outside start_* to find historical bugfixes or patterns; follow with read_memory_asset for full content"
+    },
     "read_memory_asset": {
       "description": "Read the full content and metadata of a stored memory asset by asset ID",
       "usage": "Use this after a workflow or search result already found a memory summary and you need the full reusable artifact"

package/docs/i18n/all-tools/ja.json

@@ -42,6 +42,7 @@
     "ui_search": "UI検索",
     "sync_ui_data": "データ同期",
     "code_insight": "コード洞察",
+    "search_memory": "メモリ検索",
     "read_memory_asset": "メモリ読取",
     "memorize_asset": "メモリ保存",
     "scan_and_extract_patterns": "パターン抽出",
@@ -76,7 +77,7 @@
     },
     "memory": {
       "title": "Memory と Cursor History",
-      "count": "6個"
+      "count": "7個"
     }
   },
   "toolsData": {

package/docs/i18n/all-tools/ko.json

@@ -42,6 +42,7 @@
     "ui_search": "UI 검색",
     "sync_ui_data": "데이터 동기화",
     "code_insight": "코드 인사이트",
+    "search_memory": "메모리 검색",
     "read_memory_asset": "메모리 읽기",
     "memorize_asset": "메모리 저장",
     "scan_and_extract_patterns": "패턴 추출",
@@ -76,7 +77,7 @@
     },
     "memory": {
       "title": "Memory 및 Cursor History",
-      "count": "6개"
+      "count": "7개"
     }
   },
   "toolsData": {

package/docs/i18n/all-tools/zh-CN.json

@@ -5,7 +5,7 @@
     "keywords": "AI 开发工具, 代码生成工具, 代码审查工具, Git 自动化, UI 生成, 代码重构, 性能优化, 安全扫描"
   },
   "page": {
-    "subtitle": "MCP Probe Kit 提供 28 个实用工具，核心与编排工具支持结构化输出"
+    "subtitle": "MCP Probe Kit 提供 29 个实用工具，核心与编排工具支持结构化输出"
   },
   "search": {
     "placeholder": "🔍 搜索工具名称或描述...",
@@ -41,6 +41,7 @@
     "ui_design_system": "设计系统",
     "ui_search": "搜索UI",
     "code_insight": "图谱洞察",
+    "search_memory": "搜索记忆",
     "read_memory_asset": "读取记忆",
     "memorize_asset": "沉淀记忆",
     "scan_and_extract_patterns": "抽取模式",
@@ -75,7 +76,7 @@
     },
     "memory": {
       "title": "记忆与 Cursor 历史",
-      "count": "6 个"
+      "count": "7 个"
     }
   },
   "toolsData": {
@@ -167,6 +168,10 @@
       "description": "代码图谱洞察工具，桥接 GitNexus 分析调用链、上下文和影响面（不可用时自动降级）",
       "usage": "用于刷新 GitNexus 图谱、获取任务级调用链/上下文/影响面，并把结果保存到 docs/graph-insights 与 project-context 索引"
     },
+    "search_memory": {
+      "description": "按语义检索共享记忆库，支持 type/tags 优先排序",
+      "usage": "在 start_* 之外主动查找历史 Bug 修复或可复用模式；命中后用 read_memory_asset 读全文"
+    },
     "read_memory_asset": {
       "description": "按资产 ID 读取已沉淀记忆的完整内容与元数据",
       "usage": "当编排阶段已经命中记忆摘要，需要进一步查看完整代码、规范或模式详情时使用"

package/docs/i18n/en.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI Development Enhancement Toolkit · Documentation Center",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "Quick Start",
     "visitMainSite": "Visit ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "Quick Start",
-      "description": "Get started with MCP Probe Kit v3.0.19 in 5 minutes",
+      "description": "Get started with MCP Probe Kit v3.0.21 in 5 minutes",
       "installConfig": "Installation & Configuration"
     },
     "tools": {
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "Installation & Configuration",
-    "subtitle": "Get started with MCP Probe Kit v3.0.19 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
+    "subtitle": "Get started with MCP Probe Kit v3.0.21 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
     "breadcrumb": {
       "home": "Documentation",
       "quickStart": "Quick Start",
@@ -353,7 +353,7 @@
     "subtitle": "MCP Probe Kit integrates complete development process, best practices guide from requirements to deployment",
     "overview": {
       "title": "Complete Development Process",
-      "description": "MCP Probe Kit's 28 tools cover the complete development process from requirements analysis to code deployment. Here are the recommended best practices.",
+      "description": "MCP Probe Kit's 29 tools cover the complete development process from requirements analysis to code deployment. Here are the recommended best practices.",
       "coreIdea": "Core Philosophy:",
       "coreIdeaText": "Chain the entire development process through workflow orchestration tools (start_*), making AI your development assistant."
     },
@@ -608,7 +608,7 @@
     "resources": {
       "title": "More Resources",
       "allTools": "Complete Tools Reference",
-      "allToolsDesc": "View detailed descriptions of all 28 tools",
+      "allToolsDesc": "View detailed descriptions of all 29 tools",
       "gettingStarted": "Installation & Configuration",
       "gettingStartedDesc": "Quick start guide",
       "migration": "Migration Guide",

package/docs/i18n/ja.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI開発強化ツールキット · ドキュメントセンター",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "クイックスタート",
     "visitMainSite": "ByteZoneXを訪問"
   },
   "sections": {
     "quickStart": {
       "title": "クイックスタート",
-      "description": "5分でMCP Probe Kit v3.0.19を始める",
+      "description": "5分でMCP Probe Kit v3.0.21を始める",
       "installConfig": "インストールと設定"
     },
     "tools": {

package/docs/i18n/ko.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 개발 강화 툴킷 · 문서 센터",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "빠른 시작",
     "visitMainSite": "ByteZoneX 방문"
   },
   "sections": {
     "quickStart": {
       "title": "빠른 시작",
-      "description": "5분 안에 MCP Probe Kit v3.0.19 시작하기",
+      "description": "5분 안에 MCP Probe Kit v3.0.21 시작하기",
       "installConfig": "설치 및 구성"
     },
     "tools": {

package/docs/i18n/zh-CN.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "MCP Probe Kit - AI 驱动的完整研发工具集 | 28个工具覆盖开发全流程",
-    "description": "MCP Probe Kit 提供 28 个 AI 驱动的研发工具，覆盖需求分析、代码开发、质量保障、Bug修复、版本发布全流程。支持 Cursor、Cline、Claude Desktop，100% 结构化输出。",
+    "description": "MCP Probe Kit 提供 29 个 AI 驱动的研发工具，覆盖需求分析、代码开发、质量保障、Bug修复、版本发布全流程。支持 Cursor、Cline、Claude Desktop，100% 结构化输出。",
     "keywords": "MCP Probe Kit, AI开发工具, 代码生成, 代码审查, Git工具, UI开发, 研发效率, Cursor, Cline, Claude, MCP Server"
   },
   "nav": {
@@ -14,19 +14,19 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 开发增强工具集 · 文档中心",
-    "version": "v3.0.19",
+    "version": "v3.0.21",
     "quickStart": "快速开始",
     "visitMainSite": "访问主站 ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "快速开始",
-      "description": "5 分钟快速上手 MCP Probe Kit v3.0.19",
+      "description": "5 分钟快速上手 MCP Probe Kit v3.0.21",
       "installConfig": "安装配置"
     },
     "tools": {
       "title": "工具文档",
-      "description": "28 个实用工具的完整参考，含图谱洞察与编排工作流",
+      "description": "29 个实用工具的完整参考，含图谱洞察与编排工作流",
       "allTools": "所有工具"
     },
     "guides": {
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "安装配置",
-    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.19，支持 Cursor、Cline 和 Claude Desktop",
+    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.21，支持 Cursor、Cline 和 Claude Desktop",
     "breadcrumb": {
       "home": "文档首页",
       "quickStart": "快速开始",
@@ -353,7 +353,7 @@
     "subtitle": "MCP Probe Kit 融合完整研发流程，从需求到上线的最佳实践指南",
     "overview": {
       "title": "完整研发流程",
-      "description": "MCP Probe Kit 的 28 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。",
+      "description": "MCP Probe Kit 的 29 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。",
       "coreIdea": "核心理念：",
       "coreIdeaText": "通过工作流编排工具（start_*）串联整个开发流程，让 AI 成为你的研发助手。"
     },
@@ -608,7 +608,7 @@
     "resources": {
       "title": "更多资源",
       "allTools": "完整工具参考",
-      "allToolsDesc": "查看所有 28 个工具的详细说明",
+      "allToolsDesc": "查看所有 29 个工具的详细说明",
       "gettingStarted": "安装配置",
       "gettingStartedDesc": "快速开始使用",
       "migration": "迁移指南",

package/docs/memory-local-setup.md

@@ -1,6 +1,6 @@
 # Local Memory Stack (Qdrant + Nomic Embed)
 
-This guide documents a **lightweight local setup** for mcp-probe-kit memory tools (`memorize_asset`, `read_memory_asset`, `scan_and_extract_patterns`):
+This guide documents a **lightweight local setup** for mcp-probe-kit memory tools (`search_memory`, `memorize_asset`, `read_memory_asset`, `scan_and_extract_patterns`):
 
 - **Qdrant** — vector database (port `50008`)
 - **Infinity (nomic-embed)** — embedding API (port `50012`), replaces Ollama for users who want a smaller footprint

package/docs/memory-local-setup.zh-CN.md

@@ -1,6 +1,6 @@
 # 本地记忆栈（Qdrant + Nomic Embed）
 
-面向 `memorize_asset`、`read_memory_asset`、`scan_and_extract_patterns` 的**轻量本机部署**说明：
+面向 `search_memory`、`memorize_asset`、`read_memory_asset`、`scan_and_extract_patterns` 的**轻量本机部署**说明：
 
 - **Qdrant** — 向量库（端口 `50008`）
 - **Infinity（nomic-embed）** — 向量生成（端口 `50012`），**替代 Ollama**，对用户更轻
@@ -229,7 +229,10 @@ Swagger：`http://127.0.0.1:50012/docs`
         "MEMORY_EMBEDDING_MODEL": "nomic-ai/nomic-embed-text-v1.5",
         "MEMORY_EMBEDDING_API_KEY": "与 nomic-embed/.env 中 INFINITY_API_KEY 相同",
         "MEMORY_SEARCH_LIMIT": "3",
-        "MEMORY_SUMMARY_MAX_CHARS": "280"
+        "MEMORY_SUMMARY_MAX_CHARS": "280",
+        "MEMORY_SEARCH_MIN_SCORE": "0",
+        "MEMORY_SEARCH_SHOW_SOURCE": "false",
+        "MEMORY_REPO_ID": ""
       }
     }
   }

package/docs/pages/getting-started.html

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>MCP Probe Kit - AI-Powered Complete Development Toolkit | 28 Tools Covering Entire Development Lifecycle</title>
+    <title>MCP Probe Kit - AI-Powered Complete Development Toolkit | 29 Tools Covering Entire Development Lifecycle</title>
     <meta name="i18n-title" content="meta.title">
     
     <!-- SEO Meta Tags -->
@@ -99,7 +99,7 @@
                 <a href="./all-tools.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
                     <span>🛠️</span>
                     <span data-i18n="sidebar.allTools">All Tools</span>
-                    <span class="ml-auto bg-bg-page text-xs px-2 py-0.5 rounded-full">28</span>
+                    <span class="ml-auto bg-bg-page text-xs px-2 py-0.5 rounded-full">29</span>
                 </a>
             </div>
             
@@ -250,6 +250,7 @@
                         <h3 class="font-semibold mb-2" data-i18n="gettingStarted.step1.memory.title">Memory System Setup (Qdrant + Embedding)</h3>
                         <p class="mb-3 text-text-secondary">
                             <span data-i18n="gettingStarted.step1.memory.descriptionPrefix">If you want to use</span>
+                            <code class="bg-gray-200 px-1 rounded text-xs">search_memory</code>、
                             <code class="bg-gray-200 px-1 rounded text-xs">memorize_asset</code>、
                             <code class="bg-gray-200 px-1 rounded text-xs">read_memory_asset</code>、
                             <code class="bg-gray-200 px-1 rounded text-xs">scan_and_extract_patterns</code>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.0.19",
-  "description": "AI-Powered Development Toolkit - MCP Server with 28 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
+  "version": "3.0.22",
+  "description": "AI-Powered Development Toolkit - MCP Server with 29 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
   "mcpName": "io.github.mybolide/mcp-probe-kit",
   "type": "module",
   "main": "build/index.js",