Agentero — CLI и MCP-сервер для научной библиотеки
Agentero
CLI и MCP-сервер для библиотеки научных статей: агент ищет, импортирует и читает статьи, ведет заметки Markdown в вашем хранилище
- 1 117 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Через `file_write`, `paper_notes_write` и инструменты перемещения и удаления агент может менять и удалять файлы библиотеки
- MCP-порт не требует аутентификации: любой локальный процесс получает доступ к библиотеке
- С флагом `--expose-paper-text` клиенту уходит полный текст PDF
Установка
- Работает в
Ручная установка
brew install agenteroСтавит CLI. Перед этим нужен `brew tap poco-ai/agentero`; приложение ставится как `brew install --cask agentero`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Через `file_write`, `paper_notes_write` и инструменты перемещения и удаления агент может менять и удалять файлы библиотеки
- MCP-порт не требует аутентификации: любой локальный процесс получает доступ к библиотеке
- С флагом `--expose-paper-text` клиенту уходит полный текст PDF
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Agentero — настольное приложение для научной работы: чтение PDF с пометками, заметки в Markdown с двусторонними ссылками, перевод и библиотека статей. Библиотека лежит на диске обычными файлами (PDF и Markdown). Для агентов проект дает CLI `agentero` и встроенный MCP-сервер, через которые Claude Code, Codex и другие клиенты работают с этой библиотекой. MCP-сервер слушает только loopback по адресу `http://127.0.0.1:8765/mcp`. Его включают в настройках приложения (Settings, General, MCP server) или запускают без окна командой `agentero mcp serve --vault <путь> --listen 127.0.0.1:8765`. Инструменты: `paper_list` и `paper_get` отдают метаданные, `import_id` импортирует по номеру arXiv, DOI или ссылке, `paper_notes_get` и `paper_notes_write` работают с файлом заметок статьи, есть теги и поиск по всем Markdown-файлам хранилища (`vault_search`). Чтение и запись текстовых файлов вне папки `papers` идут через `file_list`, `file_read` и `file_write`. Ресурсы `agentero://vault`, `agentero://agent-invariants` и `agentero://skills/agentero-cli` объясняют агенту правила работы. Отдельно приложение подключает локальных агентов по протоколу ACP и может отдать библиотеку ChatGPT через туннель OpenAI.
Для кого. Для исследователей и аспирантов, которые ведут библиотеку статей и хотят, чтобы Claude Code или Codex искал в ней, импортировал статьи и писал заметки.
Подходит, если
- Нужно, чтобы агент по номеру arXiv или DOI положил статью в библиотеку и создал для нее заметку
- Вы ищете в своих заметках упоминание метода и просите агента пройтись по всему хранилищу
- Библиотека лежит на удаленном сервере, и агент должен работать с ней без настольного приложения
- Хотите разметить статьи тегами и обновить метаданные (журнал, дату, DOI) пакетно
- Ведете черновик статьи в хранилище и даете агенту читать и править текстовые файлы рядом с литературой
Не подходит, если
- Нужна общая библиотека для группы: хранилище локальное, синхронизация идет через S3-совместимое облако
- Нужен доступ к чужому серверу по сети: MCP-порт без аутентификации и рассчитан только на loopback
- Библиотека живет в Zotero, и менять привычки вы не хотите: подойдет MCP-сервер для Zotero
- Нужно отдать ИИ полный текст PDF по умолчанию: он закрыт, пока не включен отдельный флаг
Пример запроса к агенту
Импортируй в библиотеку статью по DOI 10.1145/3292500.3330701, добавь тег baseline и запиши в заметку три ключевых вывода.Ограничения
Сервер без аутентификации и привязан к loopback, поэтому порт нельзя открывать в сеть, а доступ с другой машины делают через SSH-туннель. В режиме без окна нужно явно указать хранилище, а серверу приложения нужны запущенная программа и загруженное хранилище. Текст PDF клиентам не отдается, пока не включен `--expose-paper-text`. Удаленные хранилища MCP не обслуживает.
Подключение к ChatGPT требует ключа OpenAI с правами на туннели и клиента `tunnel-client`. Для Linux нужна Ubuntu 22.04 или новее. Основной README и документация на китайском, английский README есть. Доступность приложений из России при подготовке карточки не проверялась.
Как отключить. В приложении выключите переключатель MCP server в настройках, а для режима без окна остановите процесс `agentero mcp serve`. Затем удалите запись о сервере из настроек MCP вашего клиента.
Частые вопросы
Как подключить Agentero к Claude Code?
Включите MCP server в настройках приложения или запустите `agentero mcp serve --vault ~/papers`. Сервер доступен по адресу `http://127.0.0.1:8765/mcp`, подключение клиентов описано в документации проекта: https://github.com/poco-ai/agentero/blob/HEAD/docs/usage/mcp.md.
Как установить приложение и CLI?
На macOS через Homebrew: `brew tap poco-ai/agentero`, затем `brew install --cask agentero` для приложения или `brew install agentero` для CLI. Установщики для всех систем лежат на странице выпусков.
Нужно ли держать приложение открытым?
Для сервера приложения да, он работает только пока оно запущено. Без окна справляется `agentero mcp serve`: хранилище указывают флагом `--vault` или переменной `AGENTERO_VAULT`.
Что агент может изменить в библиотеке?
Метаданные статей, теги и заметки, импортировать новые статьи и записывать текстовые файлы вне папки `papers`, например черновик `drafts/main.tex`. Заметки пишутся инструментом `paper_notes_write`, а через `file_write` PDF, служебную папку `.agentero` и сами заметки трогать нельзя. Перед перезаписью заметки сервер просит агента подтвердить действие.
Чем Agentero отличается от Zotero?
Agentero хранит статьи и заметки обычными файлами и отдает их агентам через MCP, CLI и ACP. Из Zotero можно перенести всю базу с тегами, заметками и вложениями, а расширение Zotero для браузера продолжает сохранять статьи.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем
Локальный MCP-сервер позволяет агенту искать и читать вашу библиотеку Zotero, хранилище Obsidian и Apple Notes через ядро на C++
Плагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными
Два скилла для Claude Code и Codex: агент переводит научные статьи в библиотеке EasyRead и отвечает на заметки на полях
MCP-сервер для чтения PDF: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы
MCP PDF ebook: агент находит книги в папке и читает EPUB и PDF по главам и страницам, получая оглавление, метаданные и текст в Markdown
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Agentero — CLI и MCP-сервер для научной библиотеки (эта карточка) | нет | 1 117 | ||
| Zotero MCP | нет | ключ необязателен | 5 745 | подключает существующую библиотеку Zotero; Agentero ведет собственное хранилище из обычных файлов |
| arxiv-mcp-server | нет | не нужна | 3 258 | ищет и читает статьи arXiv; Agentero хранит вашу библиотеку и заметки локально |
Коротко о README
Замысел проекта: библиотека статей, заметки и диалоги с моделью обычно разбросаны по разным программам, а модели неудобны двухколоночные PDF. Поэтому формулы, таблицы и алгоритмы приложение превращает в структурированный Markdown и LaTeX. Дальше идут перевод с вашим ключом (BYOK), рекомендации arXiv, разбор списка литературы, синхронизация через S3 и перенос из Zotero.