mcp-probe-kit 3.0.24 → 3.1.0

package/build/utils/__tests__/vercel-guidelines-sync.unit.test.js

@@ -4,18 +4,18 @@ import * as fs from 'fs';
 import * as path from 'path';
 describe('vercel-guidelines-sync', () => {
     it('parses MUST/SHOULD/NEVER rules from markdown', () => {
-        const sample = `# Title
-
-## Interactions
-
-### Keyboard
-
-- MUST: Visible focus rings
-- NEVER: outline: none without replacement
-
-## Animation
-
-- SHOULD: Prefer CSS animations
+        const sample = `# Title
+
+## Interactions
+
+### Keyboard
+
+- MUST: Visible focus rings
+- NEVER: outline: none without replacement
+
+## Animation
+
+- SHOULD: Prefer CSS animations
 `;
         const records = parseVercelGuidelinesMarkdown(sample);
         expect(records).toHaveLength(3);

package/build/utils/themes-sync.js

@@ -66,14 +66,14 @@ function renderGlobalsCss(name, light, dark) {
     const toBlock = (vars) => Object.entries(vars)
         .map(([key, value]) => `    --${key}: ${value};`)
         .join('\n');
-    return `@layer base {
-  /* Theme: ${name} — paste into globals.css */
-  :root {
-${toBlock(light)}
-  }
-  .dark {
-${toBlock(dark)}
-  }
+    return `@layer base {
+  /* Theme: ${name} — paste into globals.css */
+  :root {
+${toBlock(light)}
+  }
+  .dark {
+${toBlock(dark)}
+  }
 }`;
 }
 function buildTheme(input) {

package/package.json

@@ -1,83 +1,81 @@
-{
-  "name": "mcp-probe-kit",
-  "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",
-  "main": "build/index.js",
-  "bin": {
-    "mcp-probe-kit": "build/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "postbuild": "node scripts/copy-ui-embedded-data.mjs",
-    "watch": "tsc --watch",
-    "dev": "tsc && node build/index.js",
-    "test": "vitest --run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build",
-    "sync-ui-data": "tsx scripts/sync-ui-data.ts",
-    "prebuild": "npm run sync-ui-data",
-    "docs:serve": "npx http-server docs -p 8080 -o"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "cursor",
-    "ai-tools",
-    "development-tools",
-    "code-quality",
-    "code-review",
-    "refactor",
-    "debugging",
-    "sql-generator",
-    "ui-generator",
-    "react",
-    "vue",
-    "typescript",
-    "git-tools",
-    "ai-assistant"
-  ],
-  "author": {
-    "name": "小墨 (Kyle)",
-    "url": "https://www.bytezonex.com/"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mybolide/mcp-probe-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
-  },
-  "homepage": "https://mcp-probe-kit.bytezonex.com",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "build",
-    "docs",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "cross-spawn": "^7.0.6",
-    "csv-parse": "^6.1.0",
-    "sqlite3": "^6.0.1",
-    "tar": "^7.5.6"
-  },
-  "devDependencies": {
-    "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^20.0.0",
-    "@types/tar": "^6.1.13",
-    "@vitest/ui": "^4.0.18",
-    "fast-check": "^4.5.3",
-    "tsx": "^4.21.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "mcp-probe-kit",
+  "version": "3.1.0",
+  "description": "AI-Powered Development Toolkit - MCP Server with 26 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",
+  "bin": {
+    "mcp-probe-kit": "build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "node scripts/copy-ui-embedded-data.mjs",
+    "watch": "tsc --watch",
+    "dev": "tsc && node build/index.js",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "inspector": "npx @modelcontextprotocol/inspector node build/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "sync-ui-data": "tsx scripts/sync-ui-data.ts",
+    "prebuild": "npm run sync-ui-data",
+    "docs:serve": "npx http-server docs -p 8080 -o"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cursor",
+    "ai-tools",
+    "development-tools",
+    "code-quality",
+    "code-review",
+    "refactor",
+    "debugging",
+    "sql-generator",
+    "ui-generator",
+    "react",
+    "vue",
+    "typescript",
+    "git-tools",
+    "ai-assistant"
+  ],
+  "author": {
+    "name": "小墨 (Kyle)",
+    "url": "https://www.bytezonex.com/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mybolide/mcp-probe-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mybolide/mcp-probe-kit/issues"
+  },
+  "homepage": "https://mcp-probe-kit.bytezonex.com",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "cross-spawn": "^7.0.6",
+    "csv-parse": "^6.1.0",
+    "tar": "^7.5.6"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^20.0.0",
+    "@types/tar": "^6.1.13",
+    "@vitest/ui": "^4.0.18",
+    "fast-check": "^4.5.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  }
+}

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

@@ -1,88 +0,0 @@
-import { afterEach, describe, expect, test, vi } from 'vitest';
-import { renderMemoryGuideSection, shouldShowSourceInSearch, } from '../memory-orchestration.js';
-afterEach(() => {
-    vi.unstubAllEnvs();
-});
-describe('memory-orchestration', () => {
-    test('does not show source path by default', () => {
-        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', '');
-        vi.stubEnv('MEMORY_REPO_ID', '');
-        const section = renderMemoryGuideSection({
-            enabled: true,
-            available: true,
-            degraded: false,
-            query: '404 submit',
-            results: [
-                {
-                    id: '1',
-                    score: 0.91,
-                    name: 'purchase-create-submit-404',
-                    type: 'bugfix',
-                    description: 'desc',
-                    summary: 'summary',
-                    content: '',
-                    tags: ['bugfix'],
-                    sourceProject: 'zhixing/gongyingshang',
-                    sourcePath: 'admin-api/app.js',
-                },
-            ],
-            assetsById: {},
-        });
-        expect(section).toContain('purchase-create-submit-404');
-        expect(section).not.toContain('admin-api/app.js');
-        expect(section).not.toContain('来源:');
-    });
-    test('shows source path when MEMORY_REPO_ID matches', () => {
-        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', '');
-        vi.stubEnv('MEMORY_REPO_ID', 'zhixing/gongyingshang');
-        expect(shouldShowSourceInSearch({
-            id: '1',
-            score: 0.9,
-            name: 'x',
-            type: 'bugfix',
-            description: '',
-            summary: '',
-            content: '',
-            tags: [],
-            sourceProject: 'zhixing/gongyingshang',
-            sourcePath: 'admin-api/app.js',
-        })).toBe(true);
-        expect(shouldShowSourceInSearch({
-            id: '2',
-            score: 0.9,
-            name: 'y',
-            type: 'bugfix',
-            description: '',
-            summary: '',
-            content: '',
-            tags: [],
-            sourceProject: 'other/repo',
-            sourcePath: 'src/index.ts',
-        })).toBe(false);
-    });
-    test('MEMORY_SEARCH_SHOW_SOURCE=true always shows source', () => {
-        vi.stubEnv('MEMORY_SEARCH_SHOW_SOURCE', 'true');
-        vi.stubEnv('MEMORY_REPO_ID', '');
-        const section = renderMemoryGuideSection({
-            enabled: true,
-            available: true,
-            degraded: false,
-            query: 'q',
-            results: [
-                {
-                    id: '1',
-                    score: 0.8,
-                    name: 'n',
-                    type: 'bugfix',
-                    description: '',
-                    summary: 's',
-                    content: '',
-                    tags: [],
-                    sourcePath: 'admin-api/app.js',
-                },
-            ],
-            assetsById: {},
-        });
-        expect(section).toContain('来源: admin-api/app.js');
-    });
-});

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

@@ -1,35 +0,0 @@
-import { describe, expect, test } from 'vitest';
-import { normalizeMemoryPayload, payloadToMemoryFields } from '../memory-payload.js';
-describe('memory-payload', () => {
-    test('maps legacy kind/title/source fields to current schema', () => {
-        const normalized = normalizeMemoryPayload({
-            kind: 'extracted_pattern',
-            title: 'Feishu submit success but sync_failed',
-            source: 'scan_and_extract_patterns-fallback',
-            content: 'Pattern: proxy mismatch',
-            tags: ['feishu', 'pattern'],
-            created_at: '2026-05-25T11:20:06.705Z',
-        });
-        expect(normalized.name).toBe('Feishu submit success but sync_failed');
-        expect(normalized.type).toBe('pattern');
-        expect(normalized.summary).toContain('Pattern');
-        expect(normalized.createdAt).toBe('2026-05-25T11:20:06.705Z');
-    });
-    test('payloadToMemoryFields preserves standard asset fields', () => {
-        const fields = payloadToMemoryFields({
-            id: 'asset-1',
-            name: 'purchase-create-submit-404',
-            type: 'bugfix',
-            description: '送审 404',
-            summary: 'res.data.purchase.id',
-            content: '【现象】404',
-            tags: ['bugfix'],
-            confidence: 0.95,
-            createdAt: '2026-05-27T04:28:04.684Z',
-            updatedAt: '2026-05-27T04:28:04.684Z',
-        });
-        expect(fields.name).toBe('purchase-create-submit-404');
-        expect(fields.type).toBe('bugfix');
-        expect(fields.tags).toEqual(['bugfix']);
-    });
-});

package/build/lib/cursor-history-client.d.ts

@@ -1,54 +0,0 @@
-export interface CursorConversationSummary {
-    composerId: string;
-    name: string;
-    createdAt?: number;
-    lastUpdatedAt?: number;
-    workspaceId?: string;
-    workspacePath?: string;
-    mode?: string;
-    contextUsagePercent?: number;
-    subtitle?: string;
-    isArchived?: boolean;
-    source: 'composerHeaders';
-}
-export interface CursorConversationMessage {
-    bubbleId: string;
-    type: number;
-    text: string;
-    createdAt?: string;
-    requestId?: string;
-}
-export interface CursorConversationDetail {
-    composerId: string;
-    messages: CursorConversationMessage[];
-}
-export interface CursorHistorySearchResult {
-    composerId: string;
-    conversationName: string;
-    bubbleId: string;
-    type: number;
-    text: string;
-    createdAt?: string;
-    requestId?: string;
-}
-export declare class CursorHistoryClient {
-    private withDatabase;
-    private loadConversationIndex;
-    listConversations(params?: {
-        titleQuery?: string;
-        workspaceQuery?: string;
-        includeArchived?: boolean;
-        limit?: number;
-    }): Promise<CursorConversationSummary[]>;
-    searchHistory(params: {
-        query: string;
-        composerId?: string;
-        limit?: number;
-    }): Promise<CursorHistorySearchResult[]>;
-    readConversation(params: {
-        composerId: string;
-        limit?: number;
-        includeEmpty?: boolean;
-    }): Promise<CursorConversationDetail>;
-}
-export declare function createCursorHistoryClient(): CursorHistoryClient;

package/build/lib/cursor-history-client.js

@@ -1,240 +0,0 @@
-import * as fs from 'node:fs';
-import * as os from 'node:os';
-import * as path from 'node:path';
-import sqlite3 from 'sqlite3';
-import { createToolError } from '../utils/error-handler.js';
-function parseJson(value) {
-    if (!value) {
-        return null;
-    }
-    try {
-        return JSON.parse(value);
-    }
-    catch {
-        return null;
-    }
-}
-function fileExists(filePath) {
-    try {
-        return fs.existsSync(filePath) && fs.statSync(filePath).isFile();
-    }
-    catch {
-        return false;
-    }
-}
-function resolveCursorGlobalDbPath() {
-    const appData = process.env.APPDATA?.trim();
-    const homeDir = os.homedir();
-    const candidates = [
-        appData ? path.join(appData, 'Cursor', 'User', 'globalStorage', 'state.vscdb') : '',
-        path.join(homeDir, '.config', 'Cursor', 'User', 'globalStorage', 'state.vscdb'),
-        path.join(homeDir, 'Library', 'Application Support', 'Cursor', 'User', 'globalStorage', 'state.vscdb'),
-    ].filter(Boolean);
-    const hit = candidates.find(fileExists);
-    if (!hit) {
-        throw createToolError('未找到 Cursor 全局状态库 state.vscdb', undefined, {
-            candidates,
-        });
-    }
-    return hit;
-}
-function openDatabase(dbPath) {
-    return new Promise((resolve, reject) => {
-        const db = new sqlite3.Database(dbPath, sqlite3.OPEN_READONLY, (error) => {
-            if (error) {
-                reject(createToolError(`打开 Cursor 数据库失败: ${error.message}`, error, { dbPath }));
-                return;
-            }
-            resolve(db);
-        });
-    });
-}
-function closeDatabase(db) {
-    return new Promise((resolve, reject) => {
-        db.close((error) => {
-            if (error) {
-                reject(error);
-                return;
-            }
-            resolve();
-        });
-    });
-}
-function allRows(db, sql, params = []) {
-    return new Promise((resolve, reject) => {
-        db.all(sql, params, (error, rows) => {
-            if (error) {
-                reject(error);
-                return;
-            }
-            resolve((rows ?? []));
-        });
-    });
-}
-function getRow(db, sql, params = []) {
-    return new Promise((resolve, reject) => {
-        db.get(sql, params, (error, row) => {
-            if (error) {
-                reject(error);
-                return;
-            }
-            resolve(row);
-        });
-    });
-}
-function asString(value) {
-    return typeof value === 'string' ? value : '';
-}
-function asNumber(value) {
-    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
-}
-function asBoolean(value) {
-    return typeof value === 'boolean' ? value : undefined;
-}
-function extractConversationsFromHeaders(payload) {
-    const items = payload?.allComposers ?? [];
-    return items
-        .filter((item) => item?.type === 'head')
-        .map((item) => {
-        const workspace = item.workspaceIdentifier ?? {};
-        const uri = workspace.uri ?? {};
-        return {
-            composerId: asString(item.composerId),
-            name: asString(item.name),
-            createdAt: asNumber(item.createdAt),
-            lastUpdatedAt: asNumber(item.lastUpdatedAt),
-            workspaceId: asString(workspace.id) || undefined,
-            workspacePath: asString(uri.fsPath) || undefined,
-            mode: asString(item.unifiedMode) || undefined,
-            contextUsagePercent: asNumber(item.contextUsagePercent),
-            subtitle: asString(item.subtitle) || undefined,
-            isArchived: asBoolean(item.isArchived) ?? false,
-            source: 'composerHeaders',
-        };
-    });
-}
-function extractBubbleId(key) {
-    const parts = key.split(':');
-    return parts[parts.length - 1] || key;
-}
-function extractComposerId(key) {
-    const parts = key.split(':');
-    return parts.length >= 3 ? parts[1] || '' : '';
-}
-export class CursorHistoryClient {
-    async withDatabase(runner) {
-        const dbPath = resolveCursorGlobalDbPath();
-        const db = await openDatabase(dbPath);
-        try {
-            return await runner(db);
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                throw createToolError(`读取 Cursor 历史失败: ${error.message}`, error, { dbPath });
-            }
-            throw error;
-        }
-        finally {
-            await closeDatabase(db).catch(() => undefined);
-        }
-    }
-    async loadConversationIndex(db) {
-        const row = await getRow(db, "select key, value from ItemTable where key = ?", ['composer.composerHeaders']);
-        const payload = parseJson(row?.value);
-        return extractConversationsFromHeaders(payload);
-    }
-    async listConversations(params = {}) {
-        return this.withDatabase(async (db) => {
-            const titleQuery = (params.titleQuery ?? '').trim().toLowerCase();
-            const workspaceQuery = (params.workspaceQuery ?? '').trim().toLowerCase();
-            const includeArchived = params.includeArchived ?? false;
-            const limit = Math.max(1, Math.min(params.limit ?? 20, 200));
-            const conversations = await this.loadConversationIndex(db);
-            return conversations
-                .filter((item) => includeArchived || !item.isArchived)
-                .filter((item) => !titleQuery || item.name.toLowerCase().includes(titleQuery))
-                .filter((item) => !workspaceQuery || (item.workspacePath ?? '').toLowerCase().includes(workspaceQuery))
-                .sort((a, b) => (b.lastUpdatedAt ?? 0) - (a.lastUpdatedAt ?? 0))
-                .slice(0, limit);
-        });
-    }
-    async searchHistory(params) {
-        return this.withDatabase(async (db) => {
-            const query = (params.query ?? '').trim().toLowerCase();
-            if (!query) {
-                throw new Error('缺少 query');
-            }
-            const limit = Math.max(1, Math.min(params.limit ?? 20, 200));
-            const composerId = (params.composerId ?? '').trim();
-            const index = await this.loadConversationIndex(db);
-            const names = new Map(index.map((item) => [item.composerId, item.name]));
-            const rows = await allRows(db, 'select key, value from cursorDiskKV where key like ?', [composerId ? `bubbleId:${composerId}:%` : 'bubbleId:%']);
-            const matches = rows
-                .map((row) => {
-                const parsed = parseJson(row.value);
-                if (!parsed) {
-                    return null;
-                }
-                const text = asString(parsed.text);
-                const requestId = asString(parsed.requestId);
-                const haystack = `${row.key}\n${text}\n${requestId}`.toLowerCase();
-                if (!haystack.includes(query)) {
-                    return null;
-                }
-                const currentComposerId = extractComposerId(row.key);
-                return {
-                    composerId: currentComposerId,
-                    conversationName: names.get(currentComposerId) ?? '',
-                    bubbleId: extractBubbleId(row.key),
-                    type: asNumber(parsed.type) ?? 0,
-                    text,
-                    createdAt: asString(parsed.createdAt) || undefined,
-                    requestId: requestId || undefined,
-                };
-            })
-                .filter((item) => item !== null)
-                .sort((a, b) => (b.createdAt ?? '').localeCompare(a.createdAt ?? ''))
-                .slice(0, limit);
-            return matches;
-        });
-    }
-    async readConversation(params) {
-        return this.withDatabase(async (db) => {
-            const composerId = (params.composerId ?? '').trim();
-            if (!composerId) {
-                throw new Error('缺少 composer_id');
-            }
-            const limit = Math.max(1, Math.min(params.limit ?? 200, 2000));
-            const includeEmpty = params.includeEmpty ?? false;
-            const rows = await allRows(db, 'select key, value from cursorDiskKV where key like ?', [`bubbleId:${composerId}:%`]);
-            const messages = rows
-                .map((row) => {
-                const parsed = parseJson(row.value);
-                if (!parsed) {
-                    return null;
-                }
-                const text = asString(parsed.text);
-                if (!includeEmpty && !text) {
-                    return null;
-                }
-                return {
-                    bubbleId: extractBubbleId(row.key),
-                    type: asNumber(parsed.type) ?? 0,
-                    text,
-                    createdAt: asString(parsed.createdAt) || undefined,
-                    requestId: asString(parsed.requestId) || undefined,
-                };
-            })
-                .filter((item) => item !== null)
-                .sort((a, b) => (a.createdAt ?? '').localeCompare(b.createdAt ?? ''))
-                .slice(0, limit);
-            return {
-                composerId,
-                messages,
-            };
-        });
-    }
-}
-export function createCursorHistoryClient() {
-    return new CursorHistoryClient();
-}

package/build/tools/__tests__/cursor-history.unit.test.d.ts

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

package/build/tools/__tests__/cursor-history.unit.test.js

@@ -1,38 +0,0 @@
-import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
-const readConversationMock = vi.fn();
-vi.mock('../../lib/cursor-history-client.js', () => ({
-    createCursorHistoryClient: () => ({
-        readConversation: readConversationMock,
-    }),
-}));
-import { cursorReadConversation } from '../cursor_read_conversation.js';
-beforeEach(() => {
-    readConversationMock.mockReset();
-});
-afterEach(() => {
-    vi.clearAllMocks();
-});
-describe('cursor history tools', () => {
-    test('cursor_read_conversation 返回消息时间线', async () => {
-        readConversationMock.mockResolvedValue({
-            composerId: 'c1',
-            messages: [
-                { bubbleId: 'b1', type: 1, text: '我们先聊需求' },
-                { bubbleId: 'b2', type: 2, text: '听懂了' },
-            ],
-        });
-        const result = await cursorReadConversation({ composer_id: 'c1', limit: 50, include_empty: true });
-        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('共 2 条消息');
-        expect(result.structuredContent.messageCount).toBe(2);
-        expect(readConversationMock).toHaveBeenCalledWith({
-            composerId: 'c1',
-            limit: 50,
-            includeEmpty: true,
-        });
-    });
-});