KiwiFS MCP
MCP-сервер и файловая система для markdown: агент пишет заметки, а люди читают те же файлы в веб-интерфейсе с git-историей
- 877 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент получает запись в папку знаний, а при включении веб-доступа файлы открыты по сети без шифрования на диске.
Установка
- Работает в
Ручная установка
{"mcpServers": {"kiwifs": {"command": "kiwifs", "args": ["mcp", "--root", "/path/to/knowledge"]}}}Сначала поставьте бинарник: `brew install kiwifs/tap/kiwifs` или `curl -fsSL https://raw.githubusercontent.com/kiwifs/kiwifs/main/install.sh | sh`. Хранилище создает `kiwifs init --root ./knowledge`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент получает запись в папку знаний, а при включении веб-доступа файлы открыты по сети без шифрования на диске.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
KiwiFS хранит знания как обычные файлы Markdown в папке на диске и добавляет к ним поиск, структуру и историю. Один бинарник на Go открывает веб-интерфейс на порту 3333 и REST API. Агент пишет и читает файлы через MCP, REST или обычные команды `cat` и `echo` по монтированию, а человек видит те же страницы с вики-ссылками, обратными ссылками и графом связей. Каждая запись превращается в атомарный коммит git, поэтому есть история, `git blame` и восстановление на любой момент. Поиск полнотекстовый по BM25 на SQLite FTS5 с подключаемым векторным слоем: OpenAI, Ollama, Cohere, Qdrant, pgvector и другие. Запросы DQL работают по frontmatter и умеют `TABLE`, `LIST`, `COUNT`, `WHERE` и `GROUP BY`. MCP-сервер включает более 60 инструментов и запускается командой `kiwifs mcp --root <папка>`. Остальные протоколы доступа: NFS, S3, WebDAV и FUSE. Есть 19 импортеров из Postgres, MySQL, MongoDB, Notion, Obsidian и CSV, проверка схемы при записи, вебхуки и поиск устаревших страниц и противоречий.
Для кого. Командам, которые строят общую память агентов и вики в Markdown и хотят хранить ее в своей инфраструктуре с историей изменений и веб-редактором.
Подходит, если
- Контекст агента пропадает между сессиями, и знания надо складывать в файлы, которые он сам читает и дописывает
- Вики на Confluence или Notion пора заменить папкой Markdown, которую можно целиком клонировать через git
- Нужен след каждой правки агента: кто и когда изменил страницу, с возможностью откатить
- Выгрузку из Postgres, Notion или Obsidian надо превратить в страницы с поиском и запросами по frontmatter
- Один сервер должен обслуживать несколько изолированных пространств, каждое со своим репозиторием и индексом
Не подходит, если
- Нужна только личная заметочная программа: для одного человека хватит Obsidian без сервера
- Нужна реляционная база с транзакциями: DQL читает frontmatter и заменой Postgres не служит
- Планируется платный хостинг KiwiFS для клиентов: лицензия BSL 1.1 запрещает коммерческий хостинг
- Данные не должны лежать открытым текстом: файлы Markdown на диске ничем не шифруются
Пример запроса к агенту
Запиши в KiwiFS страницу pages/auth.md с описанием входа через OAuth2 и JWT, а затем найди все страницы, где упоминается таймаут.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
KIWI_API_KEYсекрет- Ключ облачного пространства KiwiFS Cloud, нужен только для удаленного MCP.
Ограничения
Лицензия BSL 1.1 разрешает использование, самостоятельное размещение и правки, но запрещает предлагать KiwiFS как коммерческий хостинг. Каждый релиз переходит на Apache 2.0 через четыре года.
Заголовок `X-Actor` принимается как данные от клиента. На REST его перезаписывают токены с областью и OIDC, а для WebDAV и S3 доступ задают ключи, поэтому на общем сервере включайте проверку подлинности.
В документации расходятся цифры: в одном месте 62 инструмента MCP, в другом 69. Векторный поиск требует выбора и настройки модели эмбеддингов отдельно. Облачный вариант KiwiFS Cloud требует ключ `KIWI_API_KEY` и в карточку как локальный сервер не входит.
Как отключить. Удалите блок kiwifs из секции mcpServers в конфиге клиента и остановите `kiwifs serve`. Папка с Markdown и ее репозиторий git остаются у вас, их можно использовать дальше.
Частые вопросы
Как подключить KiwiFS к Claude Desktop или Cursor?
Добавьте в mcpServers команду `kiwifs` с аргументами `mcp --root <папка>`. Команда `kiwifs connect <пространство> --write auto` настроит все найденные клиенты сама.
Где лежат мои данные?
В обычных файлах Markdown в папке, которую вы указали в `--root`. Индексы поиска производные и перестраиваются из файлов.
Как устроена история изменений?
Каждая запись фиксируется атомарным коммитом git. Автором коммита служит значение заголовка `X-Actor`, а откат делается обычными средствами git.
Можно ли запустить KiwiFS в Docker?
Да: `docker run -p 3333:3333 -v ./knowledge:/data ameliaanhlam/kiwifs`. Веб-интерфейс откроется на порту 3333.
Платный ли KiwiFS?
Для самостоятельного использования бесплатный по лицензии BSL 1.1. Запрещено только предлагать его как коммерческий хостинг, для этого нужна отдельная лицензия.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCLI и MCP-сервер, который собирает из документов, кода и ссылок локальную вики с графом знаний, а агент ищет по ней вместо перебора файлов
Свой сервер долгой памяти для ИИ: шлюз к языковой модели с векторным поиском, угасанием воспоминаний и MCP-инструментами
Локальная память для ИИ-агентов в обычных Markdown-файлах: запоминает только то, что вы одобрили, и отдает ее через MCP
ai-memory сохраняет опыт сессий в Markdown-вики, подключает поиск через MCP и передает контекст между агентами и машинами.
MCP-сервер и REST API с общей памятью для Claude Code, Codex и Gemini: заметки Obsidian, сессии и багфиксы, экономный поиск.
Личная вики на LLM: граф знаний, RAG с цитатами и память, а MCP-сервер отдает их Claude Code, Claude Desktop и Cursor
Коротко о README
Описание строится на идее, что Markdown лучший общий формат для агентов и людей, а все остальное в KiwiFS производные индексы. В репозитории таблица сравнения с git, Postgres, Obsidian и Chroma, примеры настройки MCP и раздел про личность записи через `X-Actor`. Лицензия BSL 1.1.