mcp-probe-kit 3.0.23 → 3.0.24

package/README.md

@@ -100,9 +100,9 @@ A powerful MCP (Model Context Protocol) server providing **27 tools** covering t
   - Linux: `~/.config/Cursor/User/globalStorage/state.vscdb`
 
 **Memory tools:**
-- `search_memory` - Semantic search across the shared memory pool (optionally prefer `type` / `tags`); returns `id`, `score`, `summary`, and `description` in both text output and `structuredContent` (for MCP clients that only surface `content[0].text`)
+- `search_memory` - Semantic search across the shared memory pool (optionally prefer `type` / `tags`); text output includes `id`, `score`, summary, description, and a `--- content ---` body (default up to 1500 chars via `MEMORY_SEARCH_CONTENT_MAX_CHARS`)
 - `memorize_asset` - Persist reusable code/spec/pattern assets into vector memory
-- `read_memory_asset` - Read full asset content by `asset_id`
+- `read_memory_asset` - Read full asset content by `asset_id` (text output includes the full `content` body)
 - `scan_and_extract_patterns` - Extract reusable patterns from code/file/directory before deciding whether to persist
 
 **Cross-repo memory pools:** do not rely on `source_project` / `source_path` for shared retrieval; put file paths in `content` instead. Search injection hides foreign `sourcePath` unless `MEMORY_REPO_ID` matches or `MEMORY_SEARCH_SHOW_SOURCE=true`.

package/build/lib/__tests__/memory-injection.unit.test.js

@@ -20,6 +20,7 @@ describe('memory injection auto-load', () => {
                     type: 'bugfix',
                     description: 'Feishu proxy mismatch',
                     summary: 'proxy caused 400 on HTTPS',
+                    content: '【现象】submit 成功但 sync_failed\n【根因】HTTP_PROXY 污染\n【修复】proxy:false',
                     tags: ['bugfix', 'proxy'],
                 },
             ],

package/build/lib/__tests__/memory-orchestration.unit.test.js

@@ -20,6 +20,7 @@ describe('memory-orchestration', () => {
                     type: 'bugfix',
                     description: 'desc',
                     summary: 'summary',
+                    content: '',
                     tags: ['bugfix'],
                     sourceProject: 'zhixing/gongyingshang',
                     sourcePath: 'admin-api/app.js',
@@ -41,6 +42,7 @@ describe('memory-orchestration', () => {
             type: 'bugfix',
             description: '',
             summary: '',
+            content: '',
             tags: [],
             sourceProject: 'zhixing/gongyingshang',
             sourcePath: 'admin-api/app.js',
@@ -52,6 +54,7 @@ describe('memory-orchestration', () => {
             type: 'bugfix',
             description: '',
             summary: '',
+            content: '',
             tags: [],
             sourceProject: 'other/repo',
             sourcePath: 'src/index.ts',
@@ -73,6 +76,7 @@ describe('memory-orchestration', () => {
                     type: 'bugfix',
                     description: '',
                     summary: 's',
+                    content: '',
                     tags: [],
                     sourcePath: 'admin-api/app.js',
                 },

package/build/lib/memory-client.d.ts

@@ -23,6 +23,8 @@ export interface MemorySearchResult {
     type: string;
     description: string;
     summary: string;
+    /** Full payload content from Qdrant (may be empty on legacy points) */
+    content: string;
     tags: string[];
     sourceProject?: string;
     sourcePath?: string;

package/build/lib/memory-client.js

@@ -245,6 +245,7 @@ export class MemoryClient {
                 type: fields.type,
                 description: fields.description,
                 summary: truncate(fields.summary, this.config.summaryMaxChars),
+                content: fields.content,
                 tags: fields.tags,
                 sourceProject: fields.sourceProject,
                 sourcePath: fields.sourcePath,

package/build/lib/memory-config.d.ts

@@ -16,6 +16,8 @@ export interface MemoryConfig {
     repoId: string;
     /** Max chars of each asset content injected into start_* guides */
     injectionContentMaxChars: number;
+    /** Max chars of content in search_memory text; 0 = omit content block */
+    searchContentMaxChars: number;
 }
 export declare function getMemoryConfig(): MemoryConfig;
 export declare function isMemoryEnabled(config?: MemoryConfig): boolean;

package/build/lib/memory-config.js

@@ -40,6 +40,7 @@ export function getMemoryConfig() {
         searchMinScore: getOptionalNumberEnv('MEMORY_SEARCH_MIN_SCORE', 0),
         repoId: (process.env.MEMORY_REPO_ID || '').trim(),
         injectionContentMaxChars: getNumberEnv('MEMORY_INJECTION_CONTENT_MAX_CHARS', 1500),
+        searchContentMaxChars: getOptionalNumberEnv('MEMORY_SEARCH_CONTENT_MAX_CHARS', 1500),
     };
 }
 export function isMemoryEnabled(config = getMemoryConfig()) {

package/build/lib/memory-orchestration.d.ts

@@ -15,6 +15,10 @@ export declare function truncateInjectionText(value: string, maxChars: number):
 export declare function loadMemoryInjectionContext(query: string, kind?: MemoryPlanKind): Promise<MemoryInjectionContext>;
 export declare function formatSearchMemoryResultsText(results: MemorySearchResult[], config?: MemoryConfig): string;
 export declare function shouldShowSourceInSearch(item: MemorySearchResult, config?: MemoryConfig): boolean;
+export declare function formatMemoryAssetText(asset: MemoryAsset, options?: {
+    maxContentChars?: number;
+}): string;
+export declare function formatReadMemoryAssetText(asset: MemoryAsset): string;
 export declare function renderMemoryGuideSection(context: MemoryInjectionContext): string;
 export declare function buildMemoryPlanStep(kind?: MemoryPlanKind): {
     id: string;

package/build/lib/memory-orchestration.js

@@ -93,7 +93,17 @@ export function formatSearchMemoryResultsText(results, config = getMemoryConfig(
         if (shouldShowSourceInSearch(item, config) && item.sourcePath) {
             lines.push(`   - 来源: ${item.sourcePath}`);
         }
-        lines.push(`   - 全文: read_memory_asset {"asset_id": "${item.id}"}`);
+        if (config.searchContentMaxChars > 0) {
+            const body = truncateInjectionText(item.content || '', config.searchContentMaxChars);
+            lines.push('   --- content ---');
+            lines.push(body
+                ? body
+                    .split('\n')
+                    .map((line) => `   ${line}`)
+                    .join('\n')
+                : '   (empty)');
+        }
+        lines.push(`   - 更长全文: read_memory_asset {"asset_id": "${item.id}"}`);
         return lines.filter(Boolean).join('\n');
     });
     return `${header}\n\n${items.join('\n\n')}`;
@@ -113,23 +123,36 @@ function formatSourceHint(item, config) {
     }
     return `\n   - 来源: ${item.sourcePath}`;
 }
-function formatAssetBody(asset, config) {
+export function formatMemoryAssetText(asset, options) {
+    const content = options?.maxContentChars !== undefined
+        ? truncateInjectionText(asset.content, options.maxContentChars)
+        : asset.content;
     const lines = [
         `### ${asset.name}`,
         `- asset_id: ${asset.id}`,
+        asset.type ? `- type: ${asset.type}` : '',
+        asset.summary ? `- 摘要: ${asset.summary}` : '',
         asset.description ? `- 描述: ${asset.description}` : '',
         asset.usage ? `- 适用: ${asset.usage}` : '',
         asset.tags.length > 0 ? `- 标签: ${asset.tags.join(', ')}` : '',
+        asset.sourcePath ? `- 来源: ${asset.sourcePath}` : '',
         '',
-        truncateInjectionText(asset.content, config.injectionContentMaxChars),
+        '--- content ---',
+        content || '(empty)',
     ].filter(Boolean);
     return lines.join('\n');
 }
+export function formatReadMemoryAssetText(asset) {
+    return `已读取记忆资产: ${asset.name}\n\n${formatMemoryAssetText(asset)}`;
+}
+function formatAssetBody(asset, config) {
+    return formatMemoryAssetText(asset, { maxContentChars: config.injectionContentMaxChars });
+}
 function formatResultBlock(item, index, context, config) {
     const label = formatMemoryResultLabel(item);
     const asset = context.assetsById[item.id];
     const header = `${index + 1}. ${label} score=${item.score.toFixed(3)}\n   - 摘要: ${item.summary}${formatSourceHint(item, config)}`;
-    if (asset?.content) {
+    if (asset) {
         return `${header}\n\n${formatAssetBody(asset, config)}\n`;
     }
     return `${header}\n   - 全文加载失败，可手动: read_memory_asset {"asset_id": "${item.id}"}\n`;
@@ -145,7 +168,7 @@ export function renderMemoryGuideSection(context) {
     if (context.results.length === 0) {
         return `\n\n## 🧠 记忆系统\n- 状态: 已启用\n- 检索结果: 未找到高相关记录（含历史 Bug 修复与可复用模式）\n- 处理: 继续主流程；Bug 修复验证通过后必须 \`memorize_asset\` 沉淀；功能/UI 有可复用产出再沉淀\n`;
     }
-    const loadedCount = context.results.filter((item) => context.assetsById[item.id]?.content).length;
+    const loadedCount = context.results.filter((item) => Boolean(context.assetsById[item.id])).length;
     const items = context.results
         .map((item, index) => formatResultBlock(item, index, context, config))
         .join('\n');

package/build/tools/__tests__/read_memory_asset.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tools/__tests__/read_memory_asset.unit.test.js

@@ -0,0 +1,75 @@
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+const getAssetMock = vi.fn();
+const isReadEnabledMock = vi.fn();
+vi.mock('../../lib/memory-client.js', () => ({
+    createMemoryClient: () => ({
+        isReadEnabled: isReadEnabledMock,
+        getAsset: getAssetMock,
+    }),
+}));
+import { readMemoryAsset } from '../read_memory_asset.js';
+import { formatReadMemoryAssetText } from '../../lib/memory-orchestration.js';
+beforeEach(() => {
+    isReadEnabledMock.mockReset();
+    getAssetMock.mockReset();
+});
+afterEach(() => {
+    vi.clearAllMocks();
+});
+describe('formatReadMemoryAssetText', () => {
+    test('includes full content body', () => {
+        const text = formatReadMemoryAssetText({
+            id: 'asset-1',
+            name: 'playwright-e2e-testing-speed-pattern',
+            type: 'pattern',
+            description: 'Speed up Playwright E2E suites',
+            summary: 'Playwright E2E parallelization pattern',
+            content: 'export const parallelWorkers = 4;\n// use sharding',
+            tags: ['pattern', 'e2e'],
+            confidence: 0.9,
+            createdAt: '2026-01-01T00:00:00.000Z',
+            updatedAt: '2026-01-01T00:00:00.000Z',
+        });
+        expect(text).toContain('已读取记忆资产: playwright-e2e-testing-speed-pattern');
+        expect(text).toContain('--- content ---');
+        expect(text).toContain('export const parallelWorkers = 4;');
+        expect(text).toContain('asset_id: asset-1');
+    });
+});
+describe('read_memory_asset 单元测试', () => {
+    test('记忆服务未开启时返回跳过结果', async () => {
+        isReadEnabledMock.mockReturnValue(false);
+        const result = await readMemoryAsset({ asset_id: 'asset-1' });
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('记忆服务未开启');
+        expect(getAssetMock).not.toHaveBeenCalled();
+    });
+    test('命中资产时文本输出包含完整 content', async () => {
+        isReadEnabledMock.mockReturnValue(true);
+        getAssetMock.mockResolvedValue({
+            id: 'asset-1',
+            name: 'feishu-proxy-bug',
+            type: 'bugfix',
+            description: 'Feishu proxy mismatch',
+            summary: 'proxy caused 400 on HTTPS',
+            content: '【现象】submit 成功\n【根因】HTTP_PROXY 污染\n【修复】proxy:false',
+            tags: ['bugfix'],
+            confidence: 0.9,
+            createdAt: '2026-01-01T00:00:00.000Z',
+            updatedAt: '2026-01-01T00:00:00.000Z',
+        });
+        const result = await readMemoryAsset({ asset_id: 'asset-1' });
+        expect(result.isError).toBe(false);
+        expect('structuredContent' in result).toBe(true);
+        if (!('structuredContent' in result)) {
+            throw new Error('structuredContent 缺失');
+        }
+        expect(result.content[0].text).toContain('【现象】submit 成功');
+        expect(result.content[0].text).toContain('【修复】proxy:false');
+        expect(result.structuredContent.asset.content).toContain('【根因】HTTP_PROXY 污染');
+    });
+});

package/build/tools/__tests__/search_memory.unit.test.js

@@ -17,7 +17,7 @@ afterEach(() => {
     vi.clearAllMocks();
 });
 describe('formatSearchMemoryResultsText', () => {
-    test('renders id, summary, description and read hint', () => {
+    test('renders id, summary, description, content and read hint', () => {
         const text = formatSearchMemoryResultsText([
             {
                 id: '6c97bd10-654e-4f25-a560-99f7469dc11a',
@@ -26,6 +26,7 @@ describe('formatSearchMemoryResultsText', () => {
                 type: 'pattern',
                 description: 'Speed up Playwright E2E suites',
                 summary: 'Playwright E2E parallelization pattern',
+                content: 'export const parallelWorkers = 4;\n// use project-based sharding',
                 tags: ['pattern', 'e2e'],
             },
         ]);
@@ -33,6 +34,8 @@ describe('formatSearchMemoryResultsText', () => {
         expect(text).toContain('id: 6c97bd10-654e-4f25-a560-99f7469dc11a');
         expect(text).toContain('摘要: Playwright E2E parallelization pattern');
         expect(text).toContain('描述: Speed up Playwright E2E suites');
+        expect(text).toContain('--- content ---');
+        expect(text).toContain('export const parallelWorkers = 4;');
         expect(text).toContain('read_memory_asset {"asset_id": "6c97bd10-654e-4f25-a560-99f7469dc11a"}');
     });
     test('returns empty-state text', () => {
@@ -62,6 +65,7 @@ describe('search_memory 单元测试', () => {
                 type: 'bugfix',
                 description: 'Feishu proxy mismatch',
                 summary: 'proxy caused 400 on HTTPS',
+                content: '【现象】HTTPS 400\n【修复】修正 proxy 配置',
                 tags: ['bugfix', 'proxy'],
             },
         ]);
@@ -74,6 +78,8 @@ describe('search_memory 单元测试', () => {
         expect(result.content[0].text).toContain('id: asset-1');
         expect(result.content[0].text).toContain('摘要: proxy caused 400 on HTTPS');
         expect(result.content[0].text).toContain('描述: Feishu proxy mismatch');
+        expect(result.content[0].text).toContain('--- content ---');
+        expect(result.content[0].text).toContain('【修复】修正 proxy 配置');
         expect(result.structuredContent.results[0]).toEqual(expect.objectContaining({
             id: 'asset-1',
             description: 'Feishu proxy mismatch',

package/build/tools/read_memory_asset.js

@@ -1,5 +1,6 @@
 import { okStructured } from '../lib/response.js';
 import { createMemoryClient } from '../lib/memory-client.js';
+import { formatReadMemoryAssetText } from '../lib/memory-orchestration.js';
 import { handleToolError } from '../utils/error-handler.js';
 export async function readMemoryAsset(args) {
     try {
@@ -15,7 +16,7 @@ export async function readMemoryAsset(args) {
         if (!asset) {
             return okStructured(`未找到记忆资产: ${assetId}`, { enabled: true, asset: null });
         }
-        return okStructured(`已读取记忆资产: ${asset.name}`, {
+        return okStructured(formatReadMemoryAssetText(asset), {
             enabled: true,
             asset,
         });

package/build/tools/search_memory.js

@@ -42,6 +42,7 @@ export async function searchMemory(args) {
             type: item.type,
             description: item.description,
             summary: item.summary,
+            content: item.content,
             tags: item.tags,
             sourcePath: shouldShowSourceInSearch(item, config) ? item.sourcePath : undefined,
         }));

package/docs/data/tools.js

@@ -412,7 +412,7 @@ verbose: true`
         { name: 'tags', type: 'array', required: false, desc: '优先匹配的标签' },
         { name: 'limit', type: 'number', required: false, desc: '返回条数' }
       ],
-      usage: '在 start_* 之外主动查找历史 Bug 修复或可复用模式；返回文本含 id/score/summary/description，并附带 structuredContent.results',
+      usage: '在 start_* 之外主动查找历史 Bug 修复或可复用模式；文本含 id/score/摘要/描述及 --- content --- 正文（默认最多 1500 字，可用 MEMORY_SEARCH_CONTENT_MAX_CHARS 调整）',
       example: `// 使用示例
 你: 请使用 search_memory 搜索 proxy 相关 bugfix
 
@@ -427,7 +427,7 @@ limit: 5`
       params: [
         { name: 'asset_id', type: 'string', required: true, desc: '资产唯一 ID' }
       ],
-      usage: '当工作流或搜索结果已经找到 memory 摘要后，用它读取完整可复用资产',
+      usage: '当工作流或搜索结果已经找到 memory 摘要后，用它读取完整可复用资产；文本输出含 --- content --- 全文与 structuredContent.asset',
       example: `// 使用示例
 你: 请使用 read_memory_asset 工具读取资产
 

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

@@ -168,11 +168,11 @@
     },
     "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; text output includes id/score/summary/description; follow with read_memory_asset for full content"
+      "usage": "Use outside start_* to find historical bugfixes or patterns; text output includes id/score/summary/description and a --- content --- body (default 1500 chars; use read_memory_asset for unlimited full text)"
     },
     "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"
+      "usage": "Use after search_memory or orchestration hits; text output includes the full --- content --- body plus structuredContent.asset"
     },
     "memorize_asset": {
       "description": "Persist high-value code, spec, or pattern assets into the vector memory system for later reuse",

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

@@ -168,11 +168,11 @@
     },
     "search_memory": {
       "description": "按语义检索共享记忆库，支持 type/tags 优先排序",
-      "usage": "在 start_* 之外主动查找历史 Bug 修复或可复用模式；文本输出含 id/score/摘要/描述，命中后用 read_memory_asset 读全文"
+      "usage": "在 start_* 之外主动查找历史 Bug 修复或可复用模式；文本输出含 id/score/摘要/描述及 --- content --- 正文（默认最多 1500 字，更长全文用 read_memory_asset）"
     },
     "read_memory_asset": {
       "description": "按资产 ID 读取已沉淀记忆的完整内容与元数据",
-      "usage": "当编排阶段已经命中记忆摘要，需要进一步查看完整代码、规范或模式详情时使用"
+      "usage": "当编排阶段已经命中记忆摘要时使用；文本输出含 --- content --- 全文（代码/配置/详细描述）"
     },
     "memorize_asset": {
       "description": "把高价值代码、规范或模式写入向量记忆系统，供后续复用",

package/docs/i18n/en.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI Development Enhancement Toolkit · Documentation Center",
-    "version": "v3.0.23",
+    "version": "v3.0.24",
     "quickStart": "Quick Start",
     "visitMainSite": "Visit ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "Quick Start",
-      "description": "Get started with MCP Probe Kit v3.0.23 in 5 minutes",
+      "description": "Get started with MCP Probe Kit v3.0.24 in 5 minutes",
       "installConfig": "Installation & Configuration"
     },
     "tools": {
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "Installation & Configuration",
-    "subtitle": "Get started with MCP Probe Kit v3.0.23 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
+    "subtitle": "Get started with MCP Probe Kit v3.0.24 in 5 minutes. Supports Cursor, Cline, and Claude Desktop",
     "breadcrumb": {
       "home": "Documentation",
       "quickStart": "Quick Start",

package/docs/i18n/ja.json

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

package/docs/i18n/ko.json

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

package/docs/i18n/zh-CN.json

@@ -14,14 +14,14 @@
   "hero": {
     "title": "🚀 MCP Probe Kit",
     "subtitle": "AI 开发增强工具集 · 文档中心",
-    "version": "v3.0.23",
+    "version": "v3.0.24",
     "quickStart": "快速开始",
     "visitMainSite": "访问主站 ByteZoneX"
   },
   "sections": {
     "quickStart": {
       "title": "快速开始",
-      "description": "5 分钟快速上手 MCP Probe Kit v3.0.23",
+      "description": "5 分钟快速上手 MCP Probe Kit v3.0.24",
       "installConfig": "安装配置"
     },
     "tools": {
@@ -63,7 +63,7 @@
   },
   "gettingStarted": {
     "title": "安装配置",
-    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.23，支持 Cursor、Cline 和 Claude Desktop",
+    "subtitle": "5 分钟快速上手 MCP Probe Kit v3.0.24，支持 Cursor、Cline 和 Claude Desktop",
     "breadcrumb": {
       "home": "文档首页",
       "quickStart": "快速开始",

package/docs/memory-local-setup.md

@@ -262,6 +262,7 @@ After changing env, **fully restart** your MCP client (e.g. quit and reopen Curs
 | `MEMORY_EMBEDDING_PROVIDER` | No | Must be `openai-compatible` for Infinity |
 | `MEMORY_EMBEDDING_API_KEY` | Yes for Infinity | Bearer token = `INFINITY_API_KEY` |
 | `MEMORY_SEARCH_LIMIT` | No | Default `3` |
+| `MEMORY_SEARCH_CONTENT_MAX_CHARS` | No | Max `content` chars in `search_memory` text; default `1500`, `0` = summary only |
 | `MEMORY_SUMMARY_MAX_CHARS` | No | Default `280` |
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.0.23",
+  "version": "3.0.24",
   "description": "AI-Powered Development Toolkit - MCP Server with 27 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",