[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_135":136},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","memo-fs","moduleId","memofs","@memo-fs/memofs","displayName","MemoFS MCP Server","tagline","Persistent memory and virtual filesystem MCP server for AI agents.","iconKey","https://avatars.githubusercontent.com/u/303989531?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://memofs.dev/api/v1/projects/{projectId}/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1787027028000,"updatedAt",1788323584000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=dev.memofs%2Fmcp-server","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",6,"upstreamUpdatedAt",1788300620000,"detectedTransport","streamable-http","detectedAuthType","bearer","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/memo-fs/memofs","githubRepoFullName","memo-fs/memofs","releaseId","ext-memo-fs-memofs","version","1.3.0-beta.3","descriptionMarkdown","

\n\n $\"MemoFS$ \n\n# MemoFS\n\nOpen-source, file-first memory runtime for AI agents.\n\n

\n\n

\n $\"npm$ \n $\"Project$ \n $\"CI$ \n $\"Docs\"$ \n $\"MIT$ \n

\n\n---\n\n## What is MemoFS?\n\n**File-first memory runtime for AI agents.** Store, recall, and synchronize memory using plain files on disk — local-first by default, with optional cloud sync.\n\nMost AI memory systems are database-first, vendor-locked, hard to inspect, and hard to version. MemoFS inverts that: your agent's memory lives as Markdown and JSONL under a `.memofs/` directory you can `cat`, `git diff`, and roll back.\n\n```text\n.memofs/\n├── config.json # Workspace settings and engine routing\n├── manifest.json # Asset registry tracking and hashes\n├── memory/\n│ ├── core.md # Durable, project-wide facts (Markdown)\n│ └── notes.md # Timestamped notes and logs (Markdown)\n├── events/\n│ └── conversations.jsonl # Chronological interactions for recall\n├── graph/\n│ ├── nodes.jsonl # Entities extracted from memory\n│ └── edges.jsonl # Relational connections\n├── archive/ # Cold storage for deprecated memories\n│ └── .json # Full-fidelity archived memory records\n└── snapshots/\n └── snap_123.json # Versioned restore checkpoints\n```\n\n---\n\n## Quick Start\n\nReach first success in under a minute. No API keys, no database setup, no cloud required.\n\n```bash\nnpm install @memofs/core\n```\n\n```ts\nimport { MemoFS } from \"@memofs/core\";\nimport { createNodeFsMemoryStore } from \"@memofs/core/node-fs\";\n\n// Initialize a Node.js filesystem-backed memory store\nconst store = createNodeFsMemoryStore({\n rootDir: \".\",\n});\n\n// Create the unified client\nconst memo = new MemoFS({\n store,\n projectId: \"my-app\",\n mode: \"local\",\n});\n\n// Read project-wide core memory (core.md)\nconst core = await memo.core.read();\nconsole.log(core);\n\n// Record a durable note (notes.md)\nawait memo.notes.record({\n content: \"User prefers TypeScript with ESM modules.\",\n kind: \"preference\",\n});\n\n// Recall works offline (lexical BM25 + fuzzy matching) with zero config\nconst hits = await memo.recall(\"TypeScript configuration\");\n```\n\nTo upgrade to semantic/vector search, plug in an embedder adapter like OpenAI (`@memofs/adapter-openai`) or Voyage AI (`@memofs/adapter-voyage`). For **zero-API-key local vector search**, enable the ONNX embedder (`@memofs/adapter-transformers`) to run embeddings completely in-process.\n\nTo connect your coding agent (Cursor, Claude Code, etc.), use the stdio-compatible [@memofs/mcp-server](https://github.com/memo-fs/memofs/blob/main/packages/mcp-server).\n\n---\n\n## Architecture\n\n```text\nYour App / Agent / MCP client\n │\n ▼\n MemoFS (local-first runtime)\n ├─ .read() / .write() / .recall()\n ├─ .snapshot.create() / .restore()\n ├─ AgentFS (lease-locking & virtual paths)\n └─ .sync * (Cloud sync pushes and pulls)\n\n read() / write() / recall() — core client methods\n │\n ▼\n .memofs/ (plain files on disk)\n ├─ memory/core.md ├─ memory/notes.md\n ├─ events/*.jsonl ├─ graph/{nodes,edges}.jsonl\n └─ snapshots/ manifest.json\n │ git-friendly, inspectable, versionable\n ▼ (optional)\n MemoFS Cloud\n```\n\nThe runtime resolves configuration from constructor options → env vars → `.memofs/config.json`.\nThree runtime modes are supported: **`local`** (filesystem-only, default), **`hybrid`** (local + cloud sync with read/write policies), and **`memory`** (in-memory volatile, ideal for tests).\n\n### Memory Intelligence\n\n- **Code anchoring & drift detection** — bind memories to source files; stale memories are rank-demoted at recall time when anchored code changes.\n- **Memory decay floors** — kind-specific expiry thresholds (30–365 days) transition old memories to `unverified` status.\n- **Semantic GC** — archive deprecated memories to cold storage; restore on demand via `memofs restore`.\n- **Session outcomes** — `success` / `failure` / `aborted` outcome on `complete()` governing durable memory promotion and workspace cleanup.\n\n---\n\n## Packages\n\nMemoFS is structured as a monorepo containing 15 published public packages under the `@memofs/` scope. The CLI ships as `@memofs/cli` and installs the `memofs` command.\n\n### Core Engine & Servers\n\n| Package | Purpose |\n| --- | --- |\n| [`@memofs/core`](https://github.com/memo-fs/memofs/blob/main/packages/core) | Core runtime, virtual AgentFS, graph engine, and hybrid recall router. |\n| [`@memofs/cli`](https://github.com/memo-fs/memofs/blob/main/packages/cli) | CLI tool for local and cloud memory workflows (`npx memofs`). |\n| [`@memofs/server`](https://github.com/memo-fs/memofs/blob/main/packages/server) | Self-hostable, OSS-deployable memory server for Node and Workers. |\n| [`@memofs/mcp-server`](https://github.com/memo-fs/memofs/blob/main/packages/mcp-server) | Model Context Protocol server exposing memory tools to AI agents. |\n| [`@memofs/connectors`](https://github.com/memo-fs/memofs/blob/main/packages/connectors) | Local ingestion framework plugins (Notion, GitHub). |\n| [`@memofs/json-rpc`](https://github.com/memo-fs/memofs/blob/main/packages/json-rpc) | Message schemas and validation for JSON-RPC 2.0. |\n\n### Providers & Adapters\n\n| Package | Purpose |\n| --- | --- |\n| [`@memofs/adapter-ai-sdk`](https://github.com/memo-fs/memofs/blob/main/packages/adapter-ai-sdk) | Vercel AI SDK integration, runtime bridges, and tool definitions. |\n| [`@memofs/adapter-openai`](https://github.com/memo-fs/memofs/blob/main/packages/adapter-openai) | OpenAI embeddings adapter. |\n| [`@memofs/adapter-voyage`](https://github.com/memo-fs/memofs/blob/main/packages/adapter-voyage) | Voyage AI embedder and reranker adapter. |\n| [`@memofs/adapter-transformers`](https://github.com/memo-fs/memofs/blob/main/packages/adapter-transformers) | ONNX local embedder (Transformers.js) for zero-API-key hybrid recall. |\n| [`@memofs/adapter-workers-ai`](https://github.com/memo-fs/memofs/blob/main/packages/adapter-workers-ai) | Cloudflare Workers AI graph extractor adapter. |\n| [`@memofs/adapter-r2`](https://github.com/memo-fs/memofs/blob/main/packages/adapter-r2) | Cloudflare R2 Blob storage adapter. |\n| [`@memofs/adapter-turso`](https://github.com/memo-fs/memofs/blob/main/packages/adapter-turso) | Turso / libSQL metadata store adapter. |\n\n### Development Tooling\n\n| Package | Purpose |\n| --- | --- |\n| [`@memofs/testing`](https://github.com/memo-fs/memofs/blob/main/packages/testing) | Shared contract tests, mocks, fakes, and fixtures. |\n| [`@memofs/benchmark-kit`](https://github.com/memo-fs/memofs/blob/main/packages/benchmark-kit) | Benchmark workloads and runners. |\n\n---\n\n## Open Source vs. MemoFS Cloud\n\nThe **core runtime is open source** (MIT) and fully functional locally. You do not need a cloud account to run MemoFS.\n\n**MemoFS Cloud** is the memory plane for your agents: it keeps every machine, teammate, and agent on the same memory, and gives you a dashboard to see and govern it.\n\n| Feature | Open source (this repo) | MemoFS Cloud |\n| --- | --- | --- |\n| Local file-first memory | ✅ | ✅ |\n| CLI + stdio MCP server | ✅ | ✅ |\n| All adapters (OpenAI, Voyage, etc.) | ✅ | ✅ |\n| Hosted sync (keep memory in sync) | ✅ client | ✅ hosted |\n| Team workspaces & access control | — | ✅ available |\n| Memory dashboard (explore, consolidate) | — | ✅ available |\n| Hosted managed MCP endpoint | — | ✅ available (Pro+) |\n| Managed runtime (memory API over HTTPS) | — | Soon |\n\n[Join the Cloud waitlist →](https://memofs.dev)\n\n---\n\n## Repository Structure\n\n```text\nmemofs/\n├── apps/\n│ └── docs/ # VitePress documentation (docs.memofs.dev)\n├── packages/ # 15 published @memofs/* packages\n├── tooling/ # Private @repo/* workspace build packages\n├── benchmarks/ # Workspace benchmarking suite\n├── examples/ # Runnable examples\n└── package.json\n```\n\n---\n\n## Workspace Commands\n\nRun these command tasks from the repository root:\n\n```bash\n# Install all dependencies\npnpm install\n\n# Build all packages and applications\npnpm build\n\n# Run TypeScript compilation checks\npnpm typecheck\n\n# Run unit tests across all packages\npnpm test\n\n# Run code style checks (Biome)\npnpm format-and-lint\n\n# Fix linting and formatting issues automatically\npnpm format-and-lint:fix\n\n# Build documentation locally\npnpm docs:build\n```\n\n---\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](https://github.com/memo-fs/memofs/blob/main/CONTRIBUTING.md) for details on formatting, testing, and pull requests.\nFor roadmap targets, see [`ROADMAP.md`](https://github.com/memo-fs/memofs/blob/main/ROADMAP.md).\n\nFor security reports, refer to [`SECURITY.md`](https://github.com/memo-fs/memofs/blob/main/SECURITY.md) — **do not** open public issues for security vulnerabilities.\n\n---\n\n## License\n\nMIT. See [`LICENSE`](https://github.com/memo-fs/memofs/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_113":114,"_115":116,"_117":118,"_119":120,"_121":122,"_123":124},"requiredSecrets",[],"tags",[98,99,100,101,102,103,104,105,106,107,108,109,110,111,112],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","agent-memory","ai","ai-agents","ai-memory","ai-memory-system","claude-code","claude-code-hooks","claude-code-plugin","codex","codex-hooks","coding-agents","developer-tools","llm-memory","opencode","opencode-plugin","topics",[98,99,100,101,102,103,104,105,106,107,108,109,110,130,131,132,111,112,133,134],"license","MIT","language","TypeScript","registryName","dev.memofs/mcp-server","homepage","https://memofs.dev","packages",[125],{"_126":127,"_128":129,"_75":76},"registryType","npm","identifier","@memofs/mcp-server","mcp","mcp-server","model-context-protocol","recall","vector-search","ENV",{"_137":138,"_139":140,"_141":142},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]