mcp-probe-kit 3.0.18 → 3.0.21

package/docs/.mcp-probe/layout.json

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "projectRootEnv": "MCP_PROJECT_ROOT",
+  "indexPath": "AGENTS.md",
+  "contextRoot": "docs",
+  "modularDir": "docs/project-context",
+  "graphDir": "docs/graph-insights",
+  "indexStyle": "agents",
+  "generatedBy": "init_project_context",
+  "generatedAt": "2026-05-26T07:57:19.543Z"
+}

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.18",
+    "version": "v3.0.21",
     "quickStart": "Quick Start",
     "visitMainSite": "Visit ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "Quick Start",
-      "description": "Get started with MCP Probe Kit v3.0.18 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.18 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",
@@ -91,11 +91,35 @@
         "title": "Memory System Setup (Qdrant + Embedding)",
         "descriptionPrefix": "If you want to use",
         "descriptionSuffix": ", you need to configure both a vector database and an embedding service.",
+        "guideLink": "Extended guide (troubleshooting, performance):",
+        "guidePath": "docs/memory-local-setup.md",
+        "deployIntro": "Copy the files below into two folders, start both services, then paste the MCP config. No Ollama required.",
+        "portTitle": "Ports",
+        "layoutTitle": "0. Directory layout",
+        "layoutText": "Create two folders anywhere on your machine (example: ~/mcp-memory/):",
+        "qdrantTitle": "1. Qdrant (vector DB, port 50008)",
+        "qdrantCompose": "qdrant/docker-compose.yml",
+        "qdrantEnv": "qdrant/.env",
+        "qdrantDeploy": "Start Qdrant",
+        "qdrantVerify": "Verify Qdrant",
+        "qdrantNote": "When API key is enabled, all requests need header api-key. Dashboard: http://127.0.0.1:50008/dashboard",
+        "nomicTitle": "2. Nomic Embed / Infinity (embeddings, port 50012)",
+        "nomicCompose": "nomic-embed/docker-compose.yml",
+        "nomicEnv": "nomic-embed/.env",
+        "nomicDeploy": "Start embedding service",
+        "nomicVerify": "Verify embeddings",
+        "nomicNote": "First start downloads the model (~2–5 min). Use POST /embeddings (not /v1/embeddings). Returns 768-dim vectors.",
+        "mcpTitle": "3. MCP client configuration",
+        "mcpNote": "Use the same keys as in qdrant/.env and nomic-embed/.env. Restart Cursor after saving.",
+        "alternativesTitle": "Other embedding options",
         "optionA": {
-          "title": "Option A: Qdrant + Ollama (recommended)"
+          "title": "Recommended stack (steps above)"
         },
         "optionB": {
-          "title": "Option B: Qdrant + OpenAI-Compatible Embedding API"
+          "title": "Option B: Qdrant + Ollama"
+        },
+        "optionC": {
+          "title": "Option C: Qdrant + hosted OpenAI-compatible API"
         },
         "env": {
           "title": "Environment Variables",
@@ -165,6 +189,13 @@
       "claudeMac": {
         "title": "Claude Desktop (macOS)",
         "path": "Configuration file path:"
+      },
+      "opencode": {
+        "title": "OpenCode",
+        "description": "Create or edit",
+        "description2": "in project root, or globally at",
+        "note": "Note:",
+        "noteText": "OpenCode uses <code>\"environment\"</code> (not <code>\"env\"</code>) for env vars, <code>\"mcp\"</code> (not <code>\"mcpServers\"</code>), and <code>\"command\"</code> as an array with <code>\"type\": \"local\"</code> required. See <a href=\"https://opencode.ai/docs/mcp\" target=\"_blank\" rel=\"noopener\" class=\"text-primary hover:underline\">OpenCode MCP docs</a>."
       }
     },
     "step3": {
@@ -322,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."
     },
@@ -577,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.18",
+    "version": "v3.0.21",
     "quickStart": "クイックスタート",
     "visitMainSite": "ByteZoneXを訪問"
   },
   "sections": {
     "quickStart": {
       "title": "クイックスタート",
-      "description": "5分でMCP Probe Kit v3.0.18を始める",
+      "description": "5分でMCP Probe Kit v3.0.21を始める",
       "installConfig": "インストールと設定"
     },
     "tools": {
@@ -165,6 +165,13 @@
       "claudeMac": {
         "title": "Claude Desktop (macOS)",
         "path": "設定ファイルパス："
+      },
+      "opencode": {
+        "title": "OpenCode",
+        "description": "プロジェクトルートに作成・編集",
+        "description2": "、またはグローバルパス：",
+        "note": "注意：",
+        "noteText": "OpenCode は <code>\"environment\"</code>（<code>\"env\"</code> ではありません）で環境変数を指定し、<code>\"mcp\"</code>（<code>\"mcpServers\"</code> ではありません）、<code>\"command\"</code> は配列で <code>\"type\": \"local\"</code> が必須です。詳しくは <a href=\"https://opencode.ai/docs/mcp\" target=\"_blank\" rel=\"noopener\" class=\"text-primary hover:underline\">OpenCode MCP ドキュメント</a> を参照。"
       }
     },
     "step3": {

package/docs/i18n/ko.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 개발 강화 툴킷 · 문서 센터",
-    "version": "v3.0.18",
+    "version": "v3.0.21",
     "quickStart": "빠른 시작",
     "visitMainSite": "ByteZoneX 방문"
   },
   "sections": {
     "quickStart": {
       "title": "빠른 시작",
-      "description": "5분 안에 MCP Probe Kit v3.0.18 시작하기",
+      "description": "5분 안에 MCP Probe Kit v3.0.21 시작하기",
       "installConfig": "설치 및 구성"
     },
     "tools": {
@@ -165,6 +165,13 @@
       "claudeMac": {
         "title": "Claude Desktop (macOS)",
         "path": "구성 파일 경로："
+      },
+      "opencode": {
+        "title": "OpenCode",
+        "description": "프로젝트 루트에서 생성 또는 편집",
+        "description2": ", 또는 전역 경로：",
+        "note": "참고：",
+        "noteText": "OpenCode는 <code>\"environment\"</code>（<code>\"env\"</code>가 아님）로 환경 변수를 지정하고, <code>\"mcp\"</code>（<code>\"mcpServers\"</code>가 아님）, <code>\"command\"</code>는 배열이며 <code>\"type\": \"local\"</code>이 필수입니다. 자세한 내용은 <a href=\"https://opencode.ai/docs/mcp\" target=\"_blank\" rel=\"noopener\" class=\"text-primary hover:underline\">OpenCode MCP 문서</a>를 참조하세요."
       }
     },
     "step3": {

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.18",
+    "version": "v3.0.21",
     "quickStart": "快速开始",
     "visitMainSite": "访问主站 ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "快速开始",
-      "description": "5 分钟快速上手 MCP Probe Kit v3.0.18",
+      "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.18，支持 Cursor、Cline 和 Claude Desktop",
+    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.21，支持 Cursor、Cline 和 Claude Desktop",
     "breadcrumb": {
       "home": "文档首页",
       "quickStart": "快速开始",
@@ -91,11 +91,35 @@
         "title": "记忆系统安装配置（Qdrant + Embedding）",
         "descriptionPrefix": "如果你要使用",
         "descriptionSuffix": "，需要同时配置向量数据库和 embedding 服务。",
+        "guideLink": "扩展说明（排错、性能）：",
+        "guidePath": "docs/memory-local-setup.zh-CN.md",
+        "deployIntro": "按下面创建两个目录、复制 compose 与 .env、启动服务，再配置 MCP。无需安装 Ollama。",
+        "portTitle": "端口",
+        "layoutTitle": "0. 目录结构",
+        "layoutText": "在任意路径创建两个文件夹（示例 ~/mcp-memory/）：",
+        "qdrantTitle": "1. Qdrant（向量库，端口 50008）",
+        "qdrantCompose": "qdrant/docker-compose.yml",
+        "qdrantEnv": "qdrant/.env",
+        "qdrantDeploy": "启动 Qdrant",
+        "qdrantVerify": "验证 Qdrant",
+        "qdrantNote": "开启 API Key 后，请求须带 api-key 头。面板：http://127.0.0.1:50008/dashboard",
+        "nomicTitle": "2. Nomic Embed / Infinity（向量生成，端口 50012）",
+        "nomicCompose": "nomic-embed/docker-compose.yml",
+        "nomicEnv": "nomic-embed/.env",
+        "nomicDeploy": "启动 Embedding 服务",
+        "nomicVerify": "验证 Embedding",
+        "nomicNote": "首次启动会下载模型（约 2–5 分钟）。路径为 POST /embeddings（不是 /v1/embeddings），向量维度 768。",
+        "mcpTitle": "3. MCP 客户端配置",
+        "mcpNote": "密钥与 qdrant/.env、nomic-embed/.env 保持一致。保存后请完全重启 Cursor。",
+        "alternativesTitle": "其它 Embedding 方案",
         "optionA": {
-          "title": "方案 A：Qdrant + Ollama（默认推荐）"
+          "title": "推荐方案（见上文步骤）"
         },
         "optionB": {
-          "title": "方案 B：Qdrant + OpenAI-Compatible Embedding API"
+          "title": "方案 B：Qdrant + Ollama"
+        },
+        "optionC": {
+          "title": "方案 C：Qdrant + 云端 OpenAI 兼容 Embedding API"
         },
         "env": {
           "title": "环境变量说明",
@@ -165,6 +189,13 @@
       "claudeMac": {
         "title": "Claude Desktop (macOS)",
         "path": "配置文件路径："
+      },
+      "opencode": {
+        "title": "OpenCode",
+        "description": "在项目根目录创建或编辑",
+        "description2": "，或全局路径：",
+        "note": "注意：",
+        "noteText": "OpenCode 使用 <code>\"environment\"</code>（非 <code>\"env\"</code>）配置环境变量，使用 <code>\"mcp\"</code>（非 <code>\"mcpServers\"</code>），<code>\"command\"</code> 为数组且需指定 <code>\"type\": \"local\"</code>。详见 <a href=\"https://opencode.ai/docs/mcp\" target=\"_blank\" rel=\"noopener\" class=\"text-primary hover:underline\">OpenCode MCP 文档</a>。"
       }
     },
     "step3": {
@@ -322,7 +353,7 @@
     "subtitle": "MCP Probe Kit 融合完整研发流程，从需求到上线的最佳实践指南",
     "overview": {
       "title": "完整研发流程",
-      "description": "MCP Probe Kit 的 28 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。",
+      "description": "MCP Probe Kit 的 29 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。",
       "coreIdea": "核心理念：",
       "coreIdeaText": "通过工作流编排工具（start_*）串联整个开发流程，让 AI 成为你的研发助手。"
     },
@@ -577,7 +608,7 @@
     "resources": {
       "title": "更多资源",
       "allTools": "完整工具参考",
-      "allToolsDesc": "查看所有 28 个工具的详细说明",
+      "allToolsDesc": "查看所有 29 个工具的详细说明",
       "gettingStarted": "安装配置",
       "gettingStartedDesc": "快速开始使用",
       "migration": "迁移指南",