debug-lessons-mcp 1.0.0

package/README.md

@@ -0,0 +1,101 @@
+# debug-lessons-mcp
+
+跨项目共享的踩坑案例 MCP 服务。所有本地 Claude Code 实例共享同一个 SQLite 数据库。
+
+## 快速开始
+
+```bash
+npm install -g debug-lessons-mcp
+debug-lessons-mcp setup
+```
+
+重启 Claude Code 后即可使用配套 slash commands。
+
+## 配套指令
+
+| 指令 | 说明 |
+|------|------|
+| `/记录踩坑` | 引导式记录一条新的踩坑案例 |
+| `/搜索踩坑` | 在案例库中搜索类似问题 |
+| `/踩坑统计` | 查看案例统计概览和趋势 |
+| `/浏览踩坑` | 按项目/分类/模型浏览案例列表 |
+
+## 手动配置
+
+如果需要手动配置 Claude Code，在 `~/.claude/mcp.json` 中添加：
+
+```json
+{
+  "mcpServers": {
+    "debug-lessons": {
+      "command": "debug-lessons-mcp",
+      "args": [],
+      "env": {
+        "DB_PATH": "~/.claude/debug-lessons-mcp/data/debug-lessons.db"
+      }
+    }
+  }
+}
+```
+
+## CLI 命令
+
+| 命令 | 说明 |
+|------|------|
+| `debug-lessons-mcp` | 启动 MCP Server（stdio 模式） |
+| `debug-lessons-mcp setup` | 自动配置 mcp.json + 安装配套 skills |
+| `debug-lessons-mcp install-skills` | 仅安装/更新配套 slash commands |
+
+## 工具列表
+
+| 工具 | 说明 |
+|------|------|
+| `search_cases` | 全文搜索，当前项目案例加权 +50 优先 |
+| `list_cases` | 按项目/分类/模型筛选，带分页 |
+| `get_case` | 查看完整案例详情 |
+| `add_case` | 新增案例（model_id 必填） |
+| `update_case` | 编辑已有案例 |
+| `delete_case` | 删除案例（需二次确认） |
+| `get_stats` | 统计：总数、按模型/分类/项目分布、趋势 |
+| `get_models` | 列出所有模型标识及案例数 |
+| `migrate_from_json` | 从旧 JSON 批量导入 |
+
+## 数据迁移
+
+从旧版 `debug-lessons.json` 导入：
+
+```
+migrate_from_json <json_路径> <项目标识> <模型标识>
+```
+
+示例：
+```
+migrate_from_json /path/to/docs/debug-lessons.json sparx claude-opus-4-8
+```
+
+## 数据库位置
+
+`~/.claude/debug-lessons-mcp/data/debug-lessons.db`
+
+可通过 `DB_PATH` 环境变量自定义路径。
+
+## 开发
+
+```bash
+git clone https://github.com/MikkoAyaka/debug-lessons-mcp.git
+cd debug-lessons-mcp
+npm install
+npm run build
+```
+
+## 更新与卸载
+
+```bash
+# 更新
+npm update -g debug-lessons-mcp
+
+# 卸载
+npm uninstall -g debug-lessons-mcp
+# 手动删除 ~/.claude/mcp.json 中的 debug-lessons 条目
+# 手动删除 ~/.claude/skills/ 中的 记录踩坑.md 等文件
+```

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import { startServer } from "./index.js";
+import { getHomeDir, getMcpConfigPath, getSkillsDir, getDefaultDataDir, } from "./utils.js";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const PKG_VERSION = "1.0.0";
+function printHelp() {
+    console.log(`
+debug-lessons-mcp — 跨项目共享的踩坑案例 MCP 服务
+
+用法:
+  debug-lessons-mcp [命令]
+
+命令:
+  (无参数)          启动 MCP Server (stdio 模式)，供 Claude Code 调用
+  setup             自动配置 Claude Code（mcp.json + 安装配套 skills）
+  install-skills    仅安装/更新配套 slash commands 到 ~/.claude/skills/
+  --help, -h        显示此帮助
+  --version, -v     显示版本号
+
+示例:
+  npm install -g debug-lessons-mcp   # 全局安装
+  debug-lessons-mcp setup            # 一键配置
+`);
+}
+function installSkills() {
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const pkgRoot = path.resolve(__dirname, "..");
+    const skillsSrc = path.join(pkgRoot, "skills");
+    const skillsDest = getSkillsDir();
+    if (!fs.existsSync(skillsSrc)) {
+        throw new Error("skills source dir not found: " + skillsSrc);
+    }
+    fs.mkdirSync(skillsDest, { recursive: true });
+    const installed = [];
+    const entries = fs.readdirSync(skillsSrc);
+    for (const entry of entries) {
+        if (entry.endsWith(".md")) {
+            const src = path.join(skillsSrc, entry);
+            const dest = path.join(skillsDest, entry);
+            fs.copyFileSync(src, dest);
+            installed.push(entry);
+        }
+    }
+    return { installed, targetDir: skillsDest };
+}
+function readMcpConfig() {
+    const configPath = getMcpConfigPath();
+    if (fs.existsSync(configPath)) {
+        try {
+            const content = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(content);
+            return { config, existed: true };
+        }
+        catch {
+            console.warn("Warning: failed to parse mcp.json, creating new config.");
+            return { config: {}, existed: true };
+        }
+    }
+    return { config: {}, existed: false };
+}
+function writeMcpConfig(config) {
+    const configPath = getMcpConfigPath();
+    const claudeDir = path.dirname(configPath);
+    fs.mkdirSync(claudeDir, { recursive: true });
+    const content = JSON.stringify(config, null, 2) + "\n";
+    fs.writeFileSync(configPath, content, "utf-8");
+    return configPath;
+}
+function buildServerEntry() {
+    const home = getHomeDir();
+    const dbPath = path.join(home, ".claude", "debug-lessons-mcp", "data", "debug-lessons.db");
+    return {
+        command: "debug-lessons-mcp",
+        args: [],
+        env: { DB_PATH: dbPath },
+    };
+}
+async function runSetup() {
+    console.log("Configuring debug-lessons MCP service...\n");
+    const { config, existed } = readMcpConfig();
+    const serverEntry = buildServerEntry();
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    config.mcpServers["debug-lessons"] = serverEntry;
+    const configPath = writeMcpConfig(config);
+    const action = existed ? "updated" : "created";
+    console.log("mcp.json " + action + " (debug-lessons entry)");
+    const dataDir = getDefaultDataDir();
+    fs.mkdirSync(dataDir, { recursive: true });
+    console.log("Data dir: " + dataDir);
+    console.log("");
+    await runInstallSkills();
+    const dbPath = path.join(dataDir, "debug-lessons.db");
+    console.log("");
+    console.log("Setup complete! Restart Claude Code and use /record-lesson to start.");
+    console.log("");
+    console.log("  mcp.json: " + configPath);
+    console.log("  Database: " + dbPath);
+}
+async function runInstallSkills() {
+    try {
+        const { installed, targetDir } = installSkills();
+        console.log("Skills installed (" + installed.length + " slash commands)");
+        for (const name of installed) {
+            const cmdName = name.replace(/\.md$/, "");
+            console.log("  - /" + cmdName);
+        }
+        console.log("  Location: " + targetDir);
+    }
+    catch (err) {
+        console.error("Skills install failed: " + err.message);
+    }
+}
+const command = process.argv[2];
+async function main() {
+    switch (command) {
+        case undefined:
+        case "start":
+            await startServer();
+            break;
+        case "setup":
+            await runSetup();
+            break;
+        case "install-skills":
+            await runInstallSkills();
+            break;
+        case "--version":
+        case "-v":
+            console.log("debug-lessons-mcp v" + PKG_VERSION);
+            break;
+        case "--help":
+        case "-h":
+            printHelp();
+            break;
+        default:
+            console.error("Unknown command: " + command);
+            printHelp();
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/db.d.ts

@@ -0,0 +1,75 @@
+import Database from "better-sqlite3";
+export declare function getDb(): Database.Database;
+export interface DebugCase {
+    id: number;
+    project_id: string;
+    project_path: string;
+    model_id: string;
+    model_name: string;
+    category: string;
+    problem: string;
+    thinking: string;
+    result: string;
+    lesson: string;
+    tags: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CaseInput {
+    project_id?: string;
+    project_path?: string;
+    model_id: string;
+    model_name?: string;
+    category: string;
+    problem: string;
+    thinking: string;
+    result: string;
+    lesson: string;
+    tags?: string;
+}
+export interface SearchResult {
+    id: number;
+    project_id: string;
+    model_id: string;
+    category: string;
+    problem: string;
+    lesson: string;
+    tags: string;
+    score: number;
+    is_current_project: boolean;
+}
+export interface StatsResult {
+    total: number;
+    by_project: Record<string, number>;
+    by_model: Record<string, number>;
+    by_category: Record<string, number>;
+    recent_30d: number;
+    recent_7d: number;
+}
+export declare function insertCase(input: CaseInput): number;
+export declare function getCaseById(id: number): DebugCase | undefined;
+export declare function updateCase(id: number, fields: Partial<CaseInput>): boolean;
+export declare function deleteCase(id: number): boolean;
+export declare function searchCases(query: string, currentProjectId?: string, limit?: number): SearchResult[];
+export declare function listCases(options: {
+    project_id?: string;
+    category?: string;
+    model_id?: string;
+    limit?: number;
+    offset?: number;
+}): DebugCase[];
+export declare function getStats(project_id?: string): StatsResult;
+export declare function getModels(): {
+    model_id: string;
+    model_name: string;
+    count: number;
+}[];
+export interface JsonCase {
+    category: string;
+    problem: string;
+    thinking: string;
+    result: string;
+    lesson: string;
+}
+export declare function migrateFromJson(jsonPath: string, projectId: string, modelId: string): number;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"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"}

package/dist/db.js

@@ -0,0 +1,230 @@
+import Database from "better-sqlite3";
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function getDbPath() {
+    if (process.env.DB_PATH) {
+        return process.env.DB_PATH.replace(/^~/, process.env.HOME || process.env.USERPROFILE || "");
+    }
+    // Default: data/debug-lessons.db relative to project root
+    const root = path.resolve(__dirname, "..");
+    const dataDir = path.join(root, "data");
+    if (!fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
+    return path.join(dataDir, "debug-lessons.db");
+}
+let db;
+export function getDb() {
+    if (!db) {
+        const dbPath = getDbPath();
+        db = new Database(dbPath);
+        db.pragma("journal_mode = WAL");
+        db.pragma("foreign_keys = ON");
+        initSchema(db);
+    }
+    return db;
+}
+function initSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS cases (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      project_id TEXT NOT NULL,
+      project_path TEXT NOT NULL DEFAULT '',
+      model_id TEXT NOT NULL,
+      model_name TEXT NOT NULL DEFAULT '',
+      category TEXT NOT NULL,
+      problem TEXT NOT NULL,
+      thinking TEXT NOT NULL DEFAULT '',
+      result TEXT NOT NULL DEFAULT '',
+      lesson TEXT NOT NULL,
+      tags TEXT NOT NULL DEFAULT '',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_cases_project ON cases(project_id);
+    CREATE INDEX IF NOT EXISTS idx_cases_model ON cases(model_id);
+    CREATE INDEX IF NOT EXISTS idx_cases_category ON cases(category);
+    CREATE INDEX IF NOT EXISTS idx_cases_created ON cases(created_at);
+    CREATE INDEX IF NOT EXISTS idx_cases_tags ON cases(tags);
+  `);
+}
+// ---- CRUD ----
+export function insertCase(input) {
+    const db = getDb();
+    const stmt = db.prepare(`
+    INSERT INTO cases (project_id, project_path, model_id, model_name, category, problem, thinking, result, lesson, tags)
+    VALUES (@project_id, @project_path, @model_id, @model_name, @category, @problem, @thinking, @result, @lesson, @tags)
+  `);
+    const result = stmt.run({
+        project_id: input.project_id || "unknown",
+        project_path: input.project_path || "",
+        model_id: input.model_id,
+        model_name: input.model_name || "",
+        category: input.category,
+        problem: input.problem,
+        thinking: input.thinking,
+        result: input.result,
+        lesson: input.lesson,
+        tags: input.tags || "",
+    });
+    return Number(result.lastInsertRowid);
+}
+export function getCaseById(id) {
+    const db = getDb();
+    return db.prepare("SELECT * FROM cases WHERE id = ?").get(id);
+}
+export function updateCase(id, fields) {
+    const db = getDb();
+    const existing = getCaseById(id);
+    if (!existing)
+        return false;
+    const updates = [];
+    const params = { id };
+    for (const [key, value] of Object.entries(fields)) {
+        if (value !== undefined) {
+            updates.push(`${key} = @${key}`);
+            params[key] = value;
+        }
+    }
+    if (updates.length === 0)
+        return false;
+    updates.push("updated_at = datetime('now')");
+    db.prepare(`UPDATE cases SET ${updates.join(", ")} WHERE id = @id`).run(params);
+    return true;
+}
+export function deleteCase(id) {
+    const db = getDb();
+    const result = db.prepare("DELETE FROM cases WHERE id = ?").run(id);
+    return result.changes > 0;
+}
+// ---- Search ----
+export function searchCases(query, currentProjectId, limit = 10) {
+    const db = getDb();
+    const tokens = query.toLowerCase().split(/\s+/).filter(Boolean);
+    // Build a LIKE-based search across all text fields
+    const conditions = tokens
+        .map(() => `(LOWER(problem || ' ' || thinking || ' ' || result || ' ' || lesson || ' ' || tags || ' ' || category) LIKE ?)`)
+        .join(" AND ");
+    const likeParams = tokens.map((t) => `%${t}%`);
+    const rows = db
+        .prepare(`SELECT id, project_id, model_id, category, problem, lesson, tags FROM cases WHERE ${conditions}`)
+        .all(...likeParams);
+    // Score: each token match = 10 pts, exact phrase match = 20 pts, current project = 50 pts
+    const results = rows.map((row) => {
+        const text = `${row.problem} ${row.thinking} ${row.result} ${row.lesson} ${row.tags} ${row.category}`.toLowerCase();
+        let score = 0;
+        for (const t of tokens) {
+            if (text.includes(t))
+                score += 10;
+        }
+        if (text.includes(query.toLowerCase()))
+            score += 20;
+        if (currentProjectId && row.project_id === currentProjectId)
+            score += 50;
+        return {
+            id: row.id,
+            project_id: row.project_id,
+            model_id: row.model_id,
+            category: row.category,
+            problem: row.problem,
+            lesson: row.lesson,
+            tags: row.tags,
+            score,
+            is_current_project: currentProjectId ? row.project_id === currentProjectId : false,
+        };
+    });
+    // Sort by score descending, then by id descending (newer first)
+    results.sort((a, b) => b.score - a.score || b.id - a.id);
+    return results.slice(0, limit);
+}
+// ---- List ----
+export function listCases(options) {
+    const db = getDb();
+    const conditions = [];
+    const params = {};
+    if (options.project_id) {
+        conditions.push("project_id = @project_id");
+        params.project_id = options.project_id;
+    }
+    if (options.category) {
+        conditions.push("category = @category");
+        params.category = options.category;
+    }
+    if (options.model_id) {
+        conditions.push("model_id = @model_id");
+        params.model_id = options.model_id;
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+    const limit = options.limit || 50;
+    const offset = options.offset || 0;
+    return db
+        .prepare(`SELECT * FROM cases ${where} ORDER BY id DESC LIMIT ? OFFSET ?`)
+        .all(limit, offset);
+}
+// ---- Stats ----
+export function getStats(project_id) {
+    const db = getDb();
+    const whereProject = project_id ? "WHERE project_id = ?" : "";
+    const params = project_id ? [project_id] : [];
+    const total = db.prepare(`SELECT COUNT(*) as count FROM cases ${whereProject}`).get(...params).count;
+    const byProject = db
+        .prepare(`SELECT project_id, COUNT(*) as count FROM cases ${whereProject} GROUP BY project_id ORDER BY count DESC`)
+        .all(...params);
+    const byModel = db
+        .prepare(`SELECT model_id, model_name, COUNT(*) as count FROM cases ${whereProject} GROUP BY model_id ORDER BY count DESC`)
+        .all(...params);
+    const byCategory = db
+        .prepare(`SELECT category, COUNT(*) as count FROM cases ${whereProject} GROUP BY category ORDER BY count DESC`)
+        .all(...params);
+    const recent30d = db
+        .prepare(`SELECT COUNT(*) as count FROM cases ${whereProject} ${project_id ? "AND" : "WHERE"} created_at >= datetime('now', '-30 days')`)
+        .get(...params).count;
+    const recent7d = db
+        .prepare(`SELECT COUNT(*) as count FROM cases ${whereProject} ${project_id ? "AND" : "WHERE"} created_at >= datetime('now', '-7 days')`)
+        .get(...params).count;
+    return {
+        total,
+        by_project: Object.fromEntries(byProject.map((r) => [r.project_id, r.count])),
+        by_model: Object.fromEntries(byModel.map((r) => [`${r.model_id}${r.model_name ? ` (${r.model_name})` : ""}`, r.count])),
+        by_category: Object.fromEntries(byCategory.map((r) => [r.category, r.count])),
+        recent_30d: recent30d,
+        recent_7d: recent7d,
+    };
+}
+export function getModels() {
+    const db = getDb();
+    return db
+        .prepare("SELECT model_id, model_name, COUNT(*) as count FROM cases GROUP BY model_id, model_name ORDER BY count DESC")
+        .all();
+}
+export function migrateFromJson(jsonPath, projectId, modelId) {
+    const content = fs.readFileSync(jsonPath, "utf-8");
+    const cases = JSON.parse(content);
+    const db = getDb();
+    const stmt = db.prepare(`
+    INSERT INTO cases (project_id, project_path, model_id, category, problem, thinking, result, lesson)
+    VALUES (@project_id, @project_path, @model_id, @category, @problem, @thinking, @result, @lesson)
+  `);
+    const insertMany = db.transaction((items) => {
+        let count = 0;
+        for (const item of items) {
+            stmt.run({
+                project_id: projectId,
+                project_path: "",
+                model_id: modelId,
+                category: item.category,
+                problem: item.problem,
+                thinking: item.thinking,
+                result: item.result,
+                lesson: item.lesson,
+            });
+            count++;
+        }
+        return count;
+    });
+    return insertMany(cases);
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsYA,wBAAsB,WAAW,kBAIhC"}

package/dist/index.js

@@ -0,0 +1,347 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { insertCase, getCaseById, updateCase, deleteCase, searchCases, listCases, getStats, getModels, migrateFromJson, } from "./db.js";
+import { detectCurrentProject, truncate } from "./utils.js";
+// ---- Server Setup ----
+const server = new Server({
+    name: "debug-lessons-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// ---- Tool Definitions ----
+const tools = [
+    {
+        name: "search_cases",
+        description: "搜索踩坑案例。在 problem、thinking、result、lesson、tags、category 字段中全文搜索。当前项目的案例自动加权优先排在前面。返回匹配列表，包含 id、项目、模型、分类、问题摘要、教训。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "搜索关键词（支持多词，空格分隔）" },
+                project_id: { type: "string", description: "项目标识（可选，不传则自动检测）" },
+                limit: { type: "number", description: "返回数量上限（默认 10）" },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "list_cases",
+        description: "浏览踩坑案例列表。支持按项目、分类、模型筛选，带分页。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "按项目筛选（可选）" },
+                category: { type: "string", description: "按分类筛选（可选）" },
+                model_id: { type: "string", description: "按模型筛选（可选）" },
+                limit: { type: "number", description: "每页数量（默认 50）" },
+                offset: { type: "number", description: "偏移量（默认 0）" },
+            },
+        },
+    },
+    {
+        name: "get_case",
+        description: "查看一个踩坑案例的完整详情。包含 problem、thinking、result、lesson 全部字段。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "案例 ID" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "add_case",
+        description: "新增一条踩坑案例。project_id 不传则自动检测当前项目。model_id 必填，用于后续按模型统计。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "项目标识（可选，不传则自动检测）" },
+                model_id: { type: "string", description: "模型标识，如 claude-opus-4-8、deepseek-v4-pro" },
+                model_name: { type: "string", description: "模型显示名称（可选）" },
+                category: { type: "string", description: "分类，如 Docker/Build、Frontend、Database/Schema" },
+                problem: { type: "string", description: "问题描述 — 发生了什么？" },
+                thinking: { type: "string", description: "排查思路 — 当时怎么分析的？" },
+                result: { type: "string", description: "解决方案 — 最终怎么修好的？" },
+                lesson: { type: "string", description: "教训总结 — 未来如何避免？（可操作、可直接套用）" },
+                tags: { type: "string", description: "逗号分隔的标签（可选）" },
+            },
+            required: ["model_id", "category", "problem", "thinking", "result", "lesson"],
+        },
+    },
+    {
+        name: "update_case",
+        description: "编辑已有案例的任意字段。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "案例 ID" },
+                project_id: { type: "string", description: "项目标识" },
+                model_id: { type: "string", description: "模型标识" },
+                model_name: { type: "string", description: "模型显示名称" },
+                category: { type: "string", description: "分类" },
+                problem: { type: "string", description: "问题描述" },
+                thinking: { type: "string", description: "排查思路" },
+                result: { type: "string", description: "解决方案" },
+                lesson: { type: "string", description: "教训总结" },
+                tags: { type: "string", description: "标签" },
+            },
+            required: ["id"],
+        },
+    },
+    {
+        name: "delete_case",
+        description: "删除一条踩坑案例。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "number", description: "案例 ID" },
+                confirm: { type: "boolean", description: "确认删除（必须为 true）" },
+            },
+            required: ["id", "confirm"],
+        },
+    },
+    {
+        name: "get_stats",
+        description: "获取踩坑案例的统计概览：总数、按模型分布、按分类分布、按项目分布、近7/30天新增趋势。用于分析模型间差异和案例积累趋势。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "限定项目（可选，不传=全局统计）" },
+            },
+        },
+    },
+    {
+        name: "get_models",
+        description: "列出所有出现过的模型标识及案例数量。用于了解哪些模型被记录过踩坑案例，以及后续做模型间对比分析。",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "migrate_from_json",
+        description: "从旧版 debug-lessons.json 文件批量导入案例到 SQLite 数据库。适合首次从项目内 JSON 迁移到共享 MCP 服务。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                json_path: { type: "string", description: "debug-lessons.json 文件的绝对路径" },
+                project_id: { type: "string", description: "导入后归属的项目标识" },
+                model_id: { type: "string", description: "导入案例的模型标识（可后续单独修正）" },
+            },
+            required: ["json_path", "project_id", "model_id"],
+        },
+    },
+];
+// ---- Tool Handler ----
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "search_cases": {
+                const query = args.query;
+                const project = detectCurrentProject(args.project_id);
+                const limit = args.limit || 10;
+                const results = searchCases(query, project.project_id || undefined, limit);
+                if (results.length === 0) {
+                    return { content: [{ type: "text", text: "未找到匹配的案例。" }] };
+                }
+                const lines = results.map((r, i) => {
+                    const badge = r.is_current_project ? "📌" : "  ";
+                    return [
+                        `[${r.id}] ${badge} ${r.category}  │  模型: ${r.model_id}  │  项目: ${r.project_id}`,
+                        `    问题: ${truncate(r.problem, 120)}`,
+                        `    教训: ${truncate(r.lesson, 120)}`,
+                        "",
+                    ].join("\n");
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `找到 ${results.length} 条匹配案例（📌 = 当前项目）：\n\n${lines.join("\n")}`,
+                        },
+                    ],
+                };
+            }
+            case "list_cases": {
+                const rows = listCases({
+                    project_id: args.project_id,
+                    category: args.category,
+                    model_id: args.model_id,
+                    limit: args.limit || 50,
+                    offset: args.offset || 0,
+                });
+                if (rows.length === 0) {
+                    return { content: [{ type: "text", text: "没有找到案例。" }] };
+                }
+                const lines = rows.map((r) => `[${r.id}] ${r.category}  │  项目: ${r.project_id}  │  模型: ${r.model_id}  │  ${truncate(r.problem, 80)}`);
+                return {
+                    content: [{ type: "text", text: `共 ${rows.length} 条案例：\n\n${lines.join("\n")}` }],
+                };
+            }
+            case "get_case": {
+                const id = args.id;
+                const c = getCaseById(id);
+                if (!c) {
+                    return { content: [{ type: "text", text: `案例 #${id} 不存在。` }] };
+                }
+                const text = [
+                    `══════ 案例 #${c.id} ══════`,
+                    `项目:     ${c.project_id}`,
+                    `模型:     ${c.model_id}${c.model_name ? ` (${c.model_name})` : ""}`,
+                    `分类:     ${c.category}`,
+                    `标签:     ${c.tags || "（无）"}`,
+                    `创建:     ${c.created_at}`,
+                    `更新:     ${c.updated_at}`,
+                    ``,
+                    `━━━ 问题 ━━━`,
+                    c.problem,
+                    ``,
+                    `━━━ 排查思路 ━━━`,
+                    c.thinking,
+                    ``,
+                    `━━━ 解决方案 ━━━`,
+                    c.result,
+                    ``,
+                    `━━━ 教训总结 ━━━`,
+                    c.lesson,
+                ].join("\n");
+                return { content: [{ type: "text", text }] };
+            }
+            case "add_case": {
+                const project = detectCurrentProject(args.project_id);
+                const input = args;
+                const id = insertCase({
+                    project_id: project.project_id || input.project_id || "unknown",
+                    project_path: project.project_path || "",
+                    model_id: input.model_id,
+                    model_name: input.model_name || "",
+                    category: input.category,
+                    problem: input.problem,
+                    thinking: input.thinking,
+                    result: input.result,
+                    lesson: input.lesson,
+                    tags: input.tags || "",
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `✅ 案例已添加，ID: ${id}\n项目: ${project.project_id || input.project_id || "unknown"}\n模型: ${input.model_id}\n分类: ${input.category}`,
+                        },
+                    ],
+                };
+            }
+            case "update_case": {
+                const id = args.id;
+                const input = args;
+                const { id: _id, ...fields } = input;
+                const ok = updateCase(id, fields);
+                if (!ok) {
+                    return { content: [{ type: "text", text: `案例 #${id} 不存在。` }] };
+                }
+                return { content: [{ type: "text", text: `✅ 案例 #${id} 已更新。` }] };
+            }
+            case "delete_case": {
+                const id = args.id;
+                const confirm = args.confirm;
+                if (!confirm) {
+                    return {
+                        content: [{ type: "text", text: "删除操作需要 confirm: true 确认。请重新调用并设置 confirm 为 true。" }],
+                    };
+                }
+                const ok = deleteCase(id);
+                if (!ok) {
+                    return { content: [{ type: "text", text: `案例 #${id} 不存在。` }] };
+                }
+                return { content: [{ type: "text", text: `🗑️ 案例 #${id} 已删除。` }] };
+            }
+            case "get_stats": {
+                const project_id = args.project_id;
+                const stats = getStats(project_id);
+                const text = [
+                    `══════ 踩坑案例统计 ${project_id ? `(${project_id})` : "(全局)"} ══════`,
+                    ``,
+                    `总计: ${stats.total} 条`,
+                    `近 7 天新增: ${stats.recent_7d} 条`,
+                    `近 30 天新增: ${stats.recent_30d} 条`,
+                    ``,
+                    `━━━ 按项目分布 ━━━`,
+                    ...Object.entries(stats.by_project).map(([k, v]) => `  ${k}: ${v}`),
+                    ``,
+                    `━━━ 按模型分布 ━━━`,
+                    ...Object.entries(stats.by_model).map(([k, v]) => `  ${k}: ${v}`),
+                    ``,
+                    `━━━ 按分类分布 ━━━`,
+                    ...Object.entries(stats.by_category).map(([k, v]) => `  ${k}: ${v}`),
+                ].join("\n");
+                return { content: [{ type: "text", text }] };
+            }
+            case "get_models": {
+                const models = getModels();
+                if (models.length === 0) {
+                    return { content: [{ type: "text", text: "暂无任何模型记录。" }] };
+                }
+                const lines = models.map((m) => `  ${m.model_id}${m.model_name ? ` (${m.model_name})` : ""} — ${m.count} 条案例`);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `已记录的模型（共 ${models.length} 种）：\n\n${lines.join("\n")}`,
+                        },
+                    ],
+                };
+            }
+            case "migrate_from_json": {
+                const jsonPath = args.json_path;
+                const projectId = args.project_id;
+                const modelId = args.model_id;
+                const count = migrateFromJson(jsonPath, projectId, modelId);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `✅ 迁移完成：从 ${jsonPath} 导入了 ${count} 条案例。\n项目: ${projectId}\n模型: ${modelId}\n\n提示：后续可通过 update_case 逐一修正每条案例的 model_id。`,
+                        },
+                    ],
+                };
+            }
+            default:
+                return {
+                    content: [{ type: "text", text: `未知工具: ${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `错误: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
+// ---- Start ----
+export async function startServer() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Debug Lessons MCP server running on stdio");
+}
+// Auto-start when run directly (node dist/index.js), skip when imported
+const isDirectRun = process.argv[1] &&
+    (import.meta.url === `file://${process.argv[1]}` ||
+        import.meta.url === `file://${process.argv[1].replace(/\\/g, "/")}` ||
+        import.meta.url.endsWith(`/${process.argv[1].replace(/\\/g, "/").split("/").pop()}`));
+if (isDirectRun) {
+    startServer().catch((err) => {
+        console.error("Fatal error:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Get the user's home directory in a cross-platform way.
+ */
+export declare function getHomeDir(): string;
+/**
+ * Resolve a path that may start with ~ to an absolute path.
+ */
+export declare function resolveHome(filepath: string): string;
+/**
+ * Get the Claude Code config directory (~/.claude).
+ */
+export declare function getClaudeDir(): string;
+/**
+ * Get the path to mcp.json.
+ */
+export declare function getMcpConfigPath(): string;
+/**
+ * Get the path to the Claude Code skills directory.
+ */
+export declare function getSkillsDir(): string;
+/**
+ * Get the default data directory for the shared database.
+ */
+export declare function getDefaultDataDir(): string;
+/**
+ * Detect the current project ID from available sources.
+ * Priority:
+ * 1. Explicit project_id parameter (handled in tool call)
+ * 2. PROJECT_ID env var — direct project identifier (most reliable)
+ * 3. CLAUDE_PROJECT_DIR / PROJECT_DIR env var — extract dir name as project_id
+ * 4. PWD / cwd path matching
+ */
+export declare function detectCurrentProject(explicitProjectId?: string): {
+    project_id: string;
+    project_path: string;
+    source: "explicit" | "env" | "db_match" | "fallback";
+};
+/**
+ * Truncate a string to n characters, adding "..." if truncated.
+ */
+export declare function truncate(s: string, n: number): string;
+/**
+ * List known projects from the database.
+ */
+export declare function listKnownProjects(): string[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;CACtD,CAqBA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAM5C"}

package/dist/utils.js

@@ -0,0 +1,88 @@
+import { getDb } from "./db.js";
+import { homedir } from "node:os";
+import path from "node:path";
+/**
+ * Get the user's home directory in a cross-platform way.
+ */
+export function getHomeDir() {
+    return process.env.HOME || process.env.USERPROFILE || homedir();
+}
+/**
+ * Resolve a path that may start with ~ to an absolute path.
+ */
+export function resolveHome(filepath) {
+    if (filepath.startsWith("~")) {
+        return path.join(getHomeDir(), filepath.slice(1));
+    }
+    return filepath;
+}
+/**
+ * Get the Claude Code config directory (~/.claude).
+ */
+export function getClaudeDir() {
+    return path.join(getHomeDir(), ".claude");
+}
+/**
+ * Get the path to mcp.json.
+ */
+export function getMcpConfigPath() {
+    return path.join(getClaudeDir(), "mcp.json");
+}
+/**
+ * Get the path to the Claude Code skills directory.
+ */
+export function getSkillsDir() {
+    return path.join(getClaudeDir(), "skills");
+}
+/**
+ * Get the default data directory for the shared database.
+ */
+export function getDefaultDataDir() {
+    return path.join(getClaudeDir(), "debug-lessons-mcp", "data");
+}
+/**
+ * Detect the current project ID from available sources.
+ * Priority:
+ * 1. Explicit project_id parameter (handled in tool call)
+ * 2. PROJECT_ID env var — direct project identifier (most reliable)
+ * 3. CLAUDE_PROJECT_DIR / PROJECT_DIR env var — extract dir name as project_id
+ * 4. PWD / cwd path matching
+ */
+export function detectCurrentProject(explicitProjectId) {
+    // 1. Explicit parameter
+    if (explicitProjectId) {
+        return { project_id: explicitProjectId, project_path: "", source: "explicit" };
+    }
+    // 2. Direct PROJECT_ID env var
+    if (process.env.PROJECT_ID) {
+        return { project_id: process.env.PROJECT_ID, project_path: process.env.CLAUDE_PROJECT_DIR || "", source: "env" };
+    }
+    // 3. Path-based env vars — extract dir name as project_id
+    const projectDir = process.env.CLAUDE_PROJECT_DIR || process.env.PROJECT_DIR || process.env.PWD || "";
+    if (projectDir) {
+        const normalized = projectDir.replace(/\\/g, "/");
+        const dirName = normalized.split("/").filter(Boolean).pop() || normalized;
+        return { project_id: dirName, project_path: normalized, source: "env" };
+    }
+    // 4. Fallback — no detection possible
+    return { project_id: "", project_path: "", source: "fallback" };
+}
+/**
+ * Truncate a string to n characters, adding "..." if truncated.
+ */
+export function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n) + "...";
+}
+/**
+ * List known projects from the database.
+ */
+export function listKnownProjects() {
+    const db = getDb();
+    const rows = db
+        .prepare("SELECT DISTINCT project_id FROM cases ORDER BY project_id")
+        .all();
+    return rows.map((r) => r.project_id);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "debug-lessons-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for shared debugging case library across Claude Code projects",
+  "type": "module",
+  "bin": {
+    "debug-lessons-mcp": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist/",
+    "skills/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "debug",
+    "lessons",
+    "claude-code"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/skills//346/220/234/347/264/242/350/270/251/345/235/221.md

@@ -0,0 +1,29 @@
+---
+name: 搜索踩坑
+description: 在共享踩坑案例库中搜索类似问题。支持多关键词，当前项目案例自动加权优先。
+argument-hint: "[搜索关键词]"
+---
+
+# 搜索踩坑
+
+在踩坑案例库中搜索相关经验，在动手排查之前先看看有没有人踩过类似的坑。
+
+## 流程
+
+1. 如果用户在命令后提供了搜索关键词，直接使用。否则询问要搜索的内容。
+2. 调用 `search_cases` MCP tool：
+   - query: 用户提供的关键词（多词空格分隔，每个词独立匹配）
+   - 不传 project_id — 服务端自动检测当前项目，当前项目案例 +50 分加权优先
+   - limit: 最多返回 10 条
+3. 以清晰格式展示搜索结果，每条包含：
+   - 编号 [id]、📌 标记（当前项目案例）
+   - 所属项目、模型、分类
+   - 问题摘要（1-2 句话）
+   - 教训摘要（核心结论）
+4. 用户可输入编号查看完整案例详情 — 调用 `get_case` 展示完整内容（问题、排查思路、解决方案、教训总结）。
+
+## 搜索技巧
+- 用多个简短关键词比一个长句子效果好（如 "Docker 端口 冲突"）
+- 当前项目的案例标记 📌 并自动排在前面
+- 没找到完全匹配的？试试相关领域的词
+- 搜索结果按相关度排序，优先看排在前面的

package/skills//346/265/217/350/247/210/350/270/251/345/235/221.md

@@ -0,0 +1,30 @@
+---
+name: 浏览踩坑
+description: 按项目、分类或模型浏览踩坑案例列表，支持分页。
+argument-hint: "[筛选条件：项目名/分类/模型]"
+---
+
+# 浏览踩坑
+
+按条件浏览案例列表，适合不定向地翻阅和学习。
+
+## 流程
+
+1. 解析用户的筛选意图：
+   - 用户说「Docker 相关的」→ category: "Docker/Build"
+   - 用户说「sparx 项目的」→ project_id: "sparx"
+   - 用户说「Claude Opus 的案例」→ model_id: "claude-opus-4-8"
+   - 用户说「最近的案例」→ 不加筛选，按 ID 倒序（最新的在前）
+   - 用户没有提供筛选条件 → 询问想按什么维度浏览
+2. 调用 `list_cases` MCP tool：
+   - 传入对应的筛选参数（project_id / category / model_id）
+   - 默认每页 20 条
+3. 以列表形式展示结果，每条包含：
+   - [id] 分类 | 项目 | 模型 | 问题摘要（1 行）
+4. 用户可输入编号查看完整案例 → 调用 `get_case`
+5. 如果结果较多，提示用户可缩小筛选范围（如限定分类或项目）
+
+## 筛选维度参考
+- **按项目**：project_id，如 "sparx", "my-app"
+- **按分类**：Docker/Build, Frontend, Backend/API, Database/Schema, Config/Env, CI/CD, Tooling, Testing, Performance, Security
+- **按模型**：model_id，如 "claude-opus-4-8", "deepseek-v4-pro"

package/skills//350/256/260/345/275/225/350/270/251/345/235/221.md

@@ -0,0 +1,28 @@
+---
+name: 记录踩坑
+description: 记录一条调试踩坑案例到共享知识库。引导式收集问题、排查思路、解决方案和教训总结。
+argument-hint: "[遇到的问题简述]"
+---
+
+# 记录踩坑
+
+将当前调试经验记录到共享踩坑案例库。
+
+## 流程
+
+1. 如果用户在命令后提供了问题简述，以此作为起点。否则先问用户：「遇到了什么问题？」
+2. 逐项收集以下信息。如果用户一次性描述了完整经历，直接提取并确认，无需逐项询问：
+   - **问题描述** (problem) — 发生了什么？具体的错误信息或异常行为
+   - **排查思路** (thinking) — 当时怎么分析的？试过哪些方法？排除了哪些可能？
+   - **解决方案** (result) — 最终怎么修好的？具体的修改或命令
+   - **教训总结** (lesson) — 未来如何避免？要可操作、可直接套用。不要说「下次注意」，要说「在 X 场景下先检查 Y」
+   - **分类** (category) — 尝试从问题描述中推断。常见分类：Docker/Build, Frontend, Backend/API, Database/Schema, Config/Env, CI/CD, Tooling, Testing, Performance, Security, Other
+   - **标签** (tags) — 可选，逗号分隔的关键词
+3. 调用 `add_case` MCP tool 提交案例。不需传 project_id 和 model_id — 服务端自动检测。
+4. 显示保存结果（案例 ID 和关键信息摘要）。
+
+## 注意
+- 所有案例内容使用中文
+- 教训总结是核心价值——要具体、可操作、能直接套用到未来的类似场景
+- 如果用户描述不清，帮助他们梳理：从症状 → 假设 → 验证 → 结论的链条
+- category 如果拿不准，选一个最接近的即可，后续可以修改

package/skills//350/270/251/345/235/221/347/273/237/350/256/241.md

@@ -0,0 +1,23 @@
+---
+name: 踩坑统计
+description: 查看踩坑案例库的统计概览：总数、按项目/模型/分类分布、近期趋势。
+---
+
+# 踩坑统计
+
+展示踩坑案例库的统计数据和趋势分析。
+
+## 流程
+
+1. 调用 `get_stats` MCP tool 获取全局统计（不传 project_id = 全局）。
+2. 调用 `get_models` MCP tool 获取模型分布。
+3. 以结构化方式展示：
+   - **总览**：案例总数、近 7 天新增、近 30 天新增
+   - **按项目分布**：每个项目的案例数，识别最活跃的项目
+   - **按分类分布**：各类问题的频率，识别当前技术栈的高频踩坑类型
+   - **按模型分布**：每个模型记录的案例数（用于对比不同模型的行为差异）
+4. 如果发现明显的趋势或异常（如某个分类案例近期激增、某个模型问题集中），主动指出并给出建议。
+
+## 补充
+- 如果用户想只看某个项目的统计，可以传入项目名，如「看 sparx 项目的统计」
+- 统计结果可以帮助团队识别：哪些类型的 Bug 最频繁、哪个模型更容易遇到特定问题