# MemoFS MCP Server

Даёт ИИ-агенту постоянную память о проекте и виртуальную файловую систему сессий. Пригодится, когда контекст теряется между запусками.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: 0xbuffdev
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/0xbuffdev/memofs/tree/HEAD/packages/mcp-server
- Обновлён: 2026-10-18
- HTML: https://affpapa.org/nevibecode/mcp/memofs-mcp-server

## Что делает

MemoFS MCP Server подключается к агенту по stdio или HTTP и открывает 10 инструментов: четыре глагола памяти и шесть инструментов сессий AgentFS. Плюс 9 ресурсов для доступа к памяти, графу и сессиям. Агент сам решает, что запомнить, найти или обновить.

Память можно привязать к файлам исходников: `memofs.remember` принимает необязательный параметр `anchor`. Когда привязанный файл меняется, `memofs.recall` помечает запись флагом `stale`. Есть и определение устаревания: если память пережила свой порог для данного типа, recall вернёт флаг `unverified`. Завершение сессии управляется через `memofs_agent_session_complete` с параметрами `outcome`, `ephemeral` и `reason` — они задают поведение по матрице из 5 строк: что переносится в долгую память, а что вычищается из рабочей области.

Сервер работает в двух режимах рантайма (`local`, `hybrid`), умеет синхронизацию с облаком через `--cloud-url` и `--api-key`. Флаг `--read-only` блокирует изменяющие инструменты — это стоит включить, если клиент не вызывает доверия. Нужен Node.js 22 или новее. Для облачного режима понадобится ключ `MEMOFS_API_KEY`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://memofs.dev/api/v1/projects/{projectId}/mcp`
- Переменные окружения: `MEMOFS_API_KEY`, `MEMOFS_RUNTIME` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
claude mcp add --env MEMOFS_API_KEY=<MEMOFS_API_KEY> --env MEMOFS_RUNTIME=<MEMOFS_RUNTIME> --transport stdio mcp-server -- npx -y @memofs/mcp-server
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp-server https://memofs.dev/api/v1/projects/{projectId}/mcp
```

### Codex

1. **Командой платформы**
```bash
codex mcp add mcp-server --env MEMOFS_API_KEY=<MEMOFS_API_KEY> --env MEMOFS_RUNTIME=<MEMOFS_RUNTIME> -- npx -y @memofs/mcp-server
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add mcp-server --url https://memofs.dev/api/v1/projects/{projectId}/mcp
```

### Cursor

1. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@memofs/mcp-server"
            ],
            "env": {
                "MEMOFS_API_KEY": "<MEMOFS_API_KEY>",
                "MEMOFS_RUNTIME": "<MEMOFS_RUNTIME>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://memofs.dev/api/v1/projects/{projectId}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@memofs/mcp-server"
            ],
            "env": {
                "MEMOFS_API_KEY": "<MEMOFS_API_KEY>",
                "MEMOFS_RUNTIME": "<MEMOFS_RUNTIME>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

2. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://memofs.dev/api/v1/projects/{projectId}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Командой платформы**
```bash
gemini mcp add -e MEMOFS_API_KEY=<MEMOFS_API_KEY> -e MEMOFS_RUNTIME=<MEMOFS_RUNTIME> mcp-server npx -y @memofs/mcp-server
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mcp-server https://memofs.dev/api/v1/projects/{projectId}/mcp
```

## Когда брать
- сохранить договорённости о кодовой базе между сессиями агента
- найти, что агент уже знает о конкретном файле
- пометить устаревшую память, когда исходник изменился
- закрыть сессию и решить, что оставить в долгой памяти
- подключить агента к памяти по HTTP без локального запуска

## Примеры запросов агенту
- Запомни, что модуль авторизации переписан на новую библиотеку, и привяжи это к `src/auth.ts`
- Что ты помнишь об этом проекте? Покажи устаревшие записи
- Заверши сессию с исходом «успех» и не переноси временные заметки в долгую память

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md