MemoFS MCP Server — MCP-сервер для Claude Code: память агента
Даёт ИИ-агенту постоянную память о проекте и виртуальную файловую систему сессий. Пригодится, когда контекст теряется между запусками.
claude mcp add --env MEMOFS_API_KEY=<MEMOFS_API_KEY> --env MEMOFS_RUNTIME=<MEMOFS_RUNTIME> --transport stdio mcp-server -- npx -y @memofs/mcp-serverЧто делает 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.
Какие задачи решает
- сохранить договорённости о кодовой базе между сессиями агента
- найти, что агент уже знает о конкретном файле
- пометить устаревшую память, когда исходник изменился
- закрыть сессию и решить, что оставить в долгой памяти
- подключить агента к памяти по HTTP без локального запуска
Примеры запросов агенту
- Запомни, что модуль авторизации переписан на новую библиотеку, и привяжи это к
src/auth.ts - Что ты помнишь об этом проекте? Покажи устаревшие записи
- Заверши сессию с исходом «успех» и не переноси временные заметки в долгую память
Как установить MemoFS MCP Server
1Командой платформы
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Командой платформы: удалённый сервер
claude mcp add --transport http mcp-server https://memofs.dev/api/v1/projects/{projectId}/mcp1Командой платформы
codex mcp add mcp-server --env MEMOFS_API_KEY=<MEMOFS_API_KEY> --env MEMOFS_RUNTIME=<MEMOFS_RUNTIME> -- npx -y @memofs/mcp-serverВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
codex mcp add mcp-server --url https://memofs.dev/api/v1/projects/{projectId}/mcp1Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@memofs/mcp-server"
],
"env": {
"MEMOFS_API_KEY": "<MEMOFS_API_KEY>",
"MEMOFS_RUNTIME": "<MEMOFS_RUNTIME>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"mcpServers": {
"mcp-server": {
"url": "https://memofs.dev/api/v1/projects/{projectId}/mcp"
}
}
}1Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@memofs/mcp-server"
],
"env": {
"MEMOFS_API_KEY": "<MEMOFS_API_KEY>",
"MEMOFS_RUNTIME": "<MEMOFS_RUNTIME>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://memofs.dev/api/v1/projects/{projectId}/mcp"
}
}
}1Командой платформы
gemini mcp add -e MEMOFS_API_KEY=<MEMOFS_API_KEY> -e MEMOFS_RUNTIME=<MEMOFS_RUNTIME> mcp-server npx -y @memofs/mcp-serverВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
gemini mcp add -t http mcp-server https://memofs.dev/api/v1/projects/{projectId}/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MemoFS MCP Server
Как установить MemoFS MCP Server в Claude Code?
Добавьте сервер командой claude mcp add mcp-server -e MEMOFS_API_KEY=<MEMOFS_API_KEY> -- npx -y @memofs/mcp-server. Ключ подставьте свой.
Что делает MemoFS MCP Server?
Открывает агенту инструменты для чтения, поиска и обновления памяти проекта, а также инструменты сессий AgentFS. Память можно привязывать к файлам и помечать устаревшей при их изменении.
Что нужно для работы MemoFS MCP Server?
Node.js версии 22 или новее. Для облачной синхронизации нужны --cloud-url и --api-key, а в конфигурации клиента — переменная MEMOFS_API_KEY.
