warp-context-mcp 1.0.1

package/README.md

@@ -0,0 +1,82 @@
+# warp-context-mcp
+
+An MCP (Model Context Protocol) server that saves and restores conversation context across Warp account switches.
+
+When using Warp AI, switching accounts loses all conversation context. This MCP server solves that by persisting context summaries locally, so you can seamlessly resume work in a new session.
+
+## Features
+
+- **save_context** — Save current conversation context before switching accounts
+- **load_context** — Restore context in a new conversation after switching
+- **list_contexts** — List all saved project contexts
+- **delete_context** — Delete a project's context records
+
+Context is stored as local JSON files in `~/.warp-contexts/`, with up to 5 history entries per project.
+
+## Installation
+
+### Using npx (recommended)
+
+No installation needed. Configure your MCP client to run:
+
+```json
+{
+  "mcpServers": {
+    "warp-context-mcp": {
+      "command": "npx",
+      "args": ["-y", "warp-context-mcp"]
+    }
+  }
+}
+```
+
+### For Warp
+
+Add to your Warp MCP settings (`mcp_servers.json`):
+
+```json
+{
+  "mcpServers": {
+    "warp-context-mcp": {
+      "command": "npx",
+      "args": ["-y", "warp-context-mcp"]
+    }
+  }
+}
+```
+
+### For Claude Desktop
+
+Add to your Claude Desktop config (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "warp-context-mcp": {
+      "command": "npx",
+      "args": ["-y", "warp-context-mcp"]
+    }
+  }
+}
+```
+
+## Usage
+
+### Save context (before switching accounts)
+
+Tell your AI assistant:
+> "Save the current context for project X"
+
+### Load context (after switching accounts)
+
+Tell your AI assistant:
+> "Load the context for project X"
+
+## How It Works
+
+1. Before switching accounts, ask the AI to save the current context — it captures the task, progress, decisions, TODOs, key files, and next steps.
+2. After switching to a new account, ask the AI to load the context — it restores all the saved information so you can continue where you left off.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+// 上下文存储目录
+const CONTEXTS_DIR = path.join(os.homedir(), ".warp-contexts");
+// 确保存储目录存在
+function ensureDir() {
+    if (!fs.existsSync(CONTEXTS_DIR)) {
+        fs.mkdirSync(CONTEXTS_DIR, { recursive: true });
+    }
+}
+// 获取项目上下文文件路径
+function getContextPath(project) {
+    // 用安全的文件名
+    const safeName = project.replace(/[<>:"/\\|?*]/g, "_");
+    return path.join(CONTEXTS_DIR, `${safeName}.json`);
+}
+// ========== MCP Server ==========
+const server = new McpServer({
+    name: "warp-context-mcp",
+    version: "1.0.0",
+});
+// Tool 1: 保存上下文
+server.tool("save_context", "保存当前对话的上下文摘要，用于换号后恢复。在对话即将结束时调用此工具。", {
+    project: z.string().describe("项目名称，如 warp-pro-rust"),
+    task: z.string().describe("当前正在做的任务描述"),
+    progress: z.string().describe("当前进度，做到了哪一步"),
+    decisions: z.array(z.string()).describe("已做出的关键技术决策"),
+    todos: z.array(z.string()).describe("待完成的事项列表"),
+    key_files: z.array(z.string()).describe("涉及的关键文件路径"),
+    next_steps: z.string().describe("下一步计划"),
+    notes: z.string().optional().describe("其他备注信息"),
+}, async ({ project, task, progress, decisions, todos, key_files, next_steps, notes }) => {
+    ensureDir();
+    const entry = {
+        project,
+        timestamp: new Date().toISOString(),
+        task,
+        progress,
+        decisions,
+        todos,
+        key_files,
+        next_steps,
+        notes: notes ?? "",
+    };
+    const filePath = getContextPath(project);
+    // 读取已有记录，保留最近 5 条历史
+    let history = [];
+    if (fs.existsSync(filePath)) {
+        try {
+            history = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        }
+        catch {
+            history = [];
+        }
+    }
+    history.push(entry);
+    // 只保留最近 5 条
+    if (history.length > 5) {
+        history = history.slice(-5);
+    }
+    fs.writeFileSync(filePath, JSON.stringify(history, null, 2), "utf-8");
+    return {
+        content: [
+            {
+                type: "text",
+                text: `✅ 上下文已保存到项目 "${project}"（共 ${history.length} 条记录）\n文件: ${filePath}`,
+            },
+        ],
+    };
+});
+// Tool 2: 加载上下文
+server.tool("load_context", "加载指定项目的上下文摘要，用于在新对话中恢复之前的工作状态。新对话开始时调用此工具。", {
+    project: z.string().describe("项目名称"),
+    history_count: z
+        .number()
+        .optional()
+        .describe("要加载的历史记录数量，默认为 1（最新一条）"),
+}, async ({ project, history_count }) => {
+    ensureDir();
+    const filePath = getContextPath(project);
+    if (!fs.existsSync(filePath)) {
+        return {
+            content: [
+                { type: "text", text: `❌ 未找到项目 "${project}" 的上下文记录` },
+            ],
+        };
+    }
+    let history;
+    try {
+        history = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        return {
+            content: [
+                { type: "text", text: `❌ 读取项目 "${project}" 的上下文文件失败` },
+            ],
+        };
+    }
+    const count = history_count ?? 1;
+    const entries = history.slice(-count);
+    const output = entries
+        .map((e) => `## ${e.project} - ${e.timestamp}\n` +
+        `**任务**: ${e.task}\n` +
+        `**进度**: ${e.progress}\n` +
+        `**决策**: ${e.decisions.join("; ")}\n` +
+        `**待办**: ${e.todos.join("; ")}\n` +
+        `**关键文件**: ${e.key_files.join(", ")}\n` +
+        `**下一步**: ${e.next_steps}\n` +
+        (e.notes ? `**备注**: ${e.notes}\n` : ""))
+        .join("\n---\n");
+    return {
+        content: [{ type: "text", text: output }],
+    };
+});
+// Tool 3: 列出所有上下文
+server.tool("list_contexts", "列出所有已保存的项目上下文记录概览", {}, async () => {
+    ensureDir();
+    const files = fs
+        .readdirSync(CONTEXTS_DIR)
+        .filter((f) => f.endsWith(".json"));
+    if (files.length === 0) {
+        return {
+            content: [{ type: "text", text: "📭 没有已保存的上下文记录" }],
+        };
+    }
+    const summaries = files.map((f) => {
+        const filePath = path.join(CONTEXTS_DIR, f);
+        try {
+            const history = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+            const latest = history[history.length - 1];
+            return (`- **${latest.project}** (${history.length} 条记录)\n` +
+                `  最后更新: ${latest.timestamp}\n` +
+                `  任务: ${latest.task}`);
+        }
+        catch {
+            return `- **${f}** (读取失败)`;
+        }
+    });
+    return {
+        content: [{ type: "text", text: summaries.join("\n\n") }],
+    };
+});
+// Tool 4: 删除上下文
+server.tool("delete_context", "删除指定项目的上下文记录", {
+    project: z.string().describe("要删除的项目名称"),
+}, async ({ project }) => {
+    const filePath = getContextPath(project);
+    if (!fs.existsSync(filePath)) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 未找到项目 "${project}" 的上下文记录`,
+                },
+            ],
+        };
+    }
+    fs.unlinkSync(filePath);
+    return {
+        content: [
+            { type: "text", text: `🗑️ 已删除项目 "${project}" 的上下文记录` },
+        ],
+    };
+});
+// 启动 server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("warp-context-mcp server is running on stdio");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "warp-context-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for saving and restoring Warp conversation context across account switches",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "warp-context-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "warp",
+    "context",
+    "ai",
+    "claude"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.23"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@types/node": "^22.15.2"
+  }
+}