Semiont MCP
База знаний из ваших документов, где люди и ИИ-агенты ведут разметку вместе, а MCP-сервер и скиллы подключают к ней Claude Code
- 93 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- MCP-сервер читает и пишет разметку в базе от имени вошедшего пользователя
- Стек запускает контейнеры и хранит секреты, по умолчанию в простых файлах
- При облачном режиме текст документов уходит провайдеру модели
Установка
- Работает в
Ручная установка
brew install the-ai-alliance/semiont/semiontHomebrew ставит лаунчер на macOS и Linux. Для Windows в релизах лежит архив с `semiont.exe`. Нужен Docker, Podman или Apple Container.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- MCP-сервер читает и пишет разметку в базе от имени вошедшего пользователя
- Стек запускает контейнеры и хранит секреты, по умолчанию в простых файлах
- При облачном режиме текст документов уходит провайдеру модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Semiont превращает документы в базу знаний, в которой каждый факт привязан к фрагменту источника. Читатель выделяет места, ставит теги, связывает утверждение с подтверждающим текстом, а ИИ-агенты вносят ссылки и типы сущностей в той же разметке. Запись помнит, кто ее сделал, человек или агент. Запускает все программа `semiont`: статический бинарник без npm и Node.js. Команда `semiont init` создает базу в текущей папке, `semiont start` поднимает стек в контейнерах (Apple Container, Docker или Podman) и открывает браузерный интерфейс на `localhost:3000`. Для задач ИИ нужен ключ Anthropic или локальная модель через Ollama. К агентам Semiont подключается двумя путями. Команда `semiont mcp` запускает MCP-сервер по stdio: после `semiont login` Claude Code или другой MCP-клиент читает базу и пишет в нее от имени вошедшего пользователя. Набор инструментов назван по восьми глаголам протокола: `browse_`, `match_`, `gather_`, `mark_`, `yield_` и другие. Вторая часть — двенадцать скиллов в `docs/builder/skills/`, которые учат ассистента писать программы на SDK: загрузку документов, выделения, комментарии, оценки, теги, связи и сводки.
Для кого. Аналитикам и исследовательским группам, которые копят документы и хотят проверяемые ответы со ссылкой на абзац, а также разработчикам, подключающим к такой базе Claude Code.
Подходит, если
- Корпус договоров или статей нужно разметить так, чтобы каждое утверждение вело к источнику
- Агент находит связи между сущностями, а человек принимает или отклоняет каждую
- Claude Code должен искать и дописывать заметки в базе через MCP, под вашей учетной записью
- База знаний обязана жить на вашем сервере или ноутбуке без отправки документов в облако
- Нужны сводки: отчет или хронология, собранные из аннотаций к одному объекту
Не подходит, если
- Нужны личные заметки без контейнеров и входа: подойдет вариант попроще, например Obsidian
- MCP требуется как удаленная точка доступа: сервер работает на вашей машине по stdio
- Контейнерной среды нет и ставить ее нельзя: стек Semiont запускается в Docker, Podman или Apple Container
- Нужен стабильный SDK: сейчас он в альфе, и API могут меняться между 0.x
Пример запроса к агенту
Загрузи папку papers в базу Semiont и пометь все упоминания метрик качества как ссылки на сущность MetricMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
- Для запуска нужна среда контейнеров: Apple Container, Docker или Podman.
- Подсказки ИИ работают с ключом Anthropic или локальной моделью Ollama. Секреты по умолчанию лежат в простых файлах, для разработки; хранилище 1Password включается настройкой.
- SDK и API в альфе, между версиями 0.x возможны поломки.
- MCP-сервер обслуживает только вашу машину по stdio и работает от имени вошедшего пользователя, отдельной учетной записи у агента нет.
Как отключить. `claude mcp remove semiont` отключает сервер в Claude Code. Команда `semiont stop` останавливает стек, `semiont logout` завершает сессию лаунчера. Скиллы убираются удалением их папок из `.claude/skills/`.
Частые вопросы
Как подключить Semiont к Claude Code?
Выполните `semiont login`, затем `claude mcp add semiont -- semiont mcp`. Для другого MCP-клиента добавьте в конфигурацию сервер с командой `semiont` и аргументом `mcp`.
Что умеет MCP-сервер Semiont?
Он читает базу (`browse_`, `match_`, `gather_`), пишет разметку и ресурсы (`mark_`, `bind_link`, `yield_`, `frame_`), следит за задачами (`job_status`, `job_cancel`) и отдает ресурсы базы как MCP-ресурсы.
Работает ли Semiont без облака?
Да. Стек запускается локально, а вместо Anthropic можно выбрать Ollama при `semiont init --inference ollama`: в этом случае содержимое не покидает машину.
Чем скиллы Semiont отличаются от MCP-сервера?
Скиллы помогают ассистенту написать программу на SDK, а `semiont mcp` дает ИИ-приложению работать в самой базе.
На каких языках можно писать под SDK?
Документация называет TypeScript, Rust, Python, Go, Kotlin с Java, C#, Swift и Haskell.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПлагин Semantica: 17 скиллов и 3 агента для графов знаний, рассуждений и происхождения данных в Claude Code, Cursor и Codex.
Локальный MCP-сервер, который превращает папку с документами в базу знаний с гибридным поиском для Claude Code и Cursor
Граф знаний с MCP-сервером: агент ищет понятия по смыслу, видит, насколько они подтверждены, и находит спорные места в источниках.
CLI и MCP-сервер для извлечения структурированных знаний из документов: графы, гиперграфы и поиск по фактам с источниками
Самохостинг RAG-приложение с веб-интерфейсом и встроенным MCP-сервером: документы, Qdrant, ответы с источниками.
MCP-сервер InfraNodus строит из текста граф знаний и показывает кластеры тем, пробелы между ними и вопросы для исследования
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Semiont (эта карточка) | нет | не нужна | 93 | |
| Basic Memory | нет | не нужна | 4 557 | память агента в локальных Markdown-файлах, без привязки утверждений к фрагментам и совместной разметки |
| claude-obsidian | нет | 16 358 | база знаний в хранилище Obsidian, а Semiont ведет аннотации с автором каждой записи в собственном стеке |
Коротко о README
README коротко объясняет идею базы знаний с привязкой утверждений к источникам и дает команду установки через Homebrew. Ниже четыре ветки документации: для аналитика, оператора, разработчика и контрибьютора. Подробности лежат в Quick Start и в руководстве по подключению ИИ-приложений.