Initial commit

MCP server for saving and retrieving AI conversation context.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: enesakar

.env.example

@@ -0,0 +1,2 @@
+UPSTASH_REDIS_REST_URL=https://your-redis.upstash.io
+UPSTASH_REDIS_REST_TOKEN=your-redis-token

.gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.vercel
+.env

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Upstash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,135 @@
+# Memo MCP
+
+An MCP server that saves and retrieves AI conversation context. Hand off conversations between AI agents seamlessly. Free and no account required.
+
+## What it does
+
+When you're working with an AI agent and need to:
+
+- **Switch agents** - Claude can't fix your bug? Try Cursor or Copilot with dense context
+- **Continue later** - Save progress and pick up where you left off
+- **Move machines** - Start on laptop, continue on desktop
+
+Just say `memo set` and the agent will save structured context (goal, completed tasks, pending tasks, decisions, relevant files). Get a short ID back, use `memo get <id>` anywhere to restore context.
+
+## Installation
+
+### Claude Code
+
+```bash
+claude mcp add memo -- npx -y @upstash/memo
+```
+
+### Open Code
+
+```bash
+opencode mcp add memo -- npx -y @upstash/memo
+```
+
+### Claude Desktop / Cursor
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "memo": {
+      "command": "npx",
+      "args": ["-y", "@upstash/memo"]
+    }
+  }
+}
+```
+
+## Usage
+
+### Save context
+
+```
+memo set
+```
+
+The AI will summarize the conversation and return an ID like `4tJ630XqhCV5gQelx98pu`.
+
+### Restore context
+
+```
+memo get 4tJ630XqhCV5gQelx98pu
+```
+
+The AI will load the previous context and continue where you left off.
+
+## What gets saved
+
+When you run `memo set`, the agent stores a structured snapshot, for example:
+
+- Goal
+- Completed tasks
+- Pending tasks
+- Key decisions
+- Relevant files (paths only) or references
+
+This keeps restored conversations focused and avoids reloading raw chat history.
+
+## Security
+
+Your conversation context is stored in Upstash Redis with encryption enabled at rest and in transit. Data expires automatically after 24 hours (configurable via `--ttl-mins`).
+
+If you prefer full control over your data, you can self-host both the API and storage using your own infrastructure. See the Self-hosting section below.
+
+## Self-hosting
+
+The repo includes both the MCP server and the API. To self-host:
+
+### 1. Set up environment
+
+Create a `.env` file with your Upstash Redis credentials:
+
+```
+UPSTASH_REDIS_REST_URL=your-redis-url
+UPSTASH_REDIS_REST_TOKEN=your-redis-token
+```
+
+### 2. Run locally
+
+```bash
+npx vercel dev
+```
+
+### 3. Deploy to Vercel
+
+```bash
+vercel
+```
+
+Set the same environment variables in your Vercel project settings.
+
+### 4. Point MCP to your API
+
+The MCP server uses `https://memo.upstash.com` by default. To use your own API, modify `index.ts`:
+
+```typescript
+const GET_URL = "https://your-api.vercel.app/api/get";
+const SET_URL = "https://your-api.vercel.app/api/set";
+```
+
+## Options
+
+### `--ttl-mins`
+
+Set expiration time in minutes. Default is 1440 (24 hours).
+
+```json
+{
+  "mcpServers": {
+    "memo": {
+      "command": "npx",
+      "args": ["-y", "@upstash/memo", "--ttl-mins", "4320"]
+    }
+  }
+}
+```
+
+## License
+
+MIT

api/index.ts

@@ -0,0 +1,68 @@
+import { Hono } from "hono";
+import { Redis } from "@upstash/redis";
+import { Ratelimit } from "@upstash/ratelimit";
+import { nanoid } from "nanoid";
+
+const redis = new Redis({
+  url: process.env.UPSTASH_REDIS_REST_URL!,
+  token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+});
+
+const ratelimit = new Ratelimit({
+  redis,
+  limiter: Ratelimit.slidingWindow(60, "1 m"),
+});
+
+const app = new Hono().basePath("/api");
+
+// Rate limit middleware
+app.use(async (c, next) => {
+  const ip = c.req.header("x-forwarded-for")?.split(",")[0] || "anonymous";
+  const { success, remaining } = await ratelimit.limit(ip);
+  c.header("X-RateLimit-Remaining", remaining.toString());
+  if (!success) {
+    return c.json({ error: "Rate limit exceeded" }, 429);
+  }
+  return next();
+});
+
+// Accept id from query params, path, or body
+app.all("/get/:id?", async (c) => {
+  let id = c.req.param("id") || c.req.query("id");
+
+  // Try body if not in query/path
+  if (!id) {
+    try {
+      const body = await c.req.json();
+      id = body.id;
+    } catch {
+      // No body or invalid JSON
+    }
+  }
+
+  if (!id) {
+    return c.json({ error: "Missing id parameter" }, 400);
+  }
+  const summary = await redis.get(id);
+  if (!summary) {
+    return c.json({ error: "Summary not found" }, 404);
+  }
+  // Upstash auto-parses JSON, so stringify if we got an object back
+  const summaryStr = typeof summary === "string" ? summary : JSON.stringify(summary);
+  return c.json({ summary: summaryStr });
+});
+
+app.post("/set", async (c) => {
+  const body = await c.req.json();
+  // Accept summary, context, or data field
+  const summary = body.summary || body.context || body.data;
+  if (!summary) {
+    return c.json({ error: "Missing summary/context/data field" }, 400);
+  }
+  const ttlMins = body.ttlMins || 1440; // 24 hours
+  const id = nanoid();
+  await redis.set(id, summary, { ex: ttlMins * 60 });
+  return c.json({ id, message: "Data received" });
+});
+
+export default app;