open-notebook — MCP-сервер для Claude Code
Подключает ИИ-ассистента к API сервиса Open Notebook для ведения заметок, загрузки источников и семантического поиска. Пригодится для работы с личной базой знаний прямо из чата.
claude mcp add open-notebook -e OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL> -e OPEN_NOTEBOOK_PASSWORD=<OPEN_NOTEBOOK_PASSWORD> -- uvx open-notebook-mcpЧто делает open-notebook
Сервер предоставляет 39 инструментов для работы с блокнотами, заметками, веб-ссылками, текстовыми выжимками и сессиями чата. В систему заложен механизм progressive disclosure: инструмент search_capabilities позволяет модели находить нужные методы по поисковому запросу, чтобы не перегружать контекстное окно полным перечнем сразу.
Решение поддерживает текстовый и векторный поиск по материалам, а также передачу вопросов через настроенные языковые модели. Связь с клиентом организуется по протоколам stdio либо Streamable HTTP.
Для запуска необходим работающий сервис Open Notebook, адрес которого передаётся через OPEN_NOTEBOOK_URL. Без поднятого инстанса запросы завершатся ошибкой по таймауту в 30 секунд.
Какие задачи решает
- искать фрагменты в блокнотах по смыслу или ключевым словам
- сохранять веб-ссылки и текстовые заметки с расчётом эмбеддингов
- управлять сессиями чата и контекстом обсуждений внутри проектов
- настраивать модели и читать конфигурацию через API Open Notebook
Примеры запросов агенту
- Найди в блокноте AI Research все заметки про векторный поиск
- Добавь ссылку
https://example.com/ai-articleкак источник в проект и сгенерируй эмбеддинги - Покажи список доступных моделей в Open Notebook через
search_capabilities
Как установить open-notebook
Командой платформы
claude mcp add open-notebook -e OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL> -e OPEN_NOTEBOOK_PASSWORD=<OPEN_NOTEBOOK_PASSWORD> -- uvx open-notebook-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from open-notebook-mcp <команда>
Командой платформы
codex mcp add open-notebook --env OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL> --env OPEN_NOTEBOOK_PASSWORD=<OPEN_NOTEBOOK_PASSWORD> -- uvx open-notebook-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from open-notebook-mcp <команда>
Файл настроек
{
"mcpServers": {
"open-notebook": {
"command": "uvx",
"args": [
"open-notebook-mcp"
],
"env": {
"OPEN_NOTEBOOK_URL": "<OPEN_NOTEBOOK_URL>",
"OPEN_NOTEBOOK_PASSWORD": "<OPEN_NOTEBOOK_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from open-notebook-mcp <команда>
Файл настроек
{
"servers": {
"open-notebook": {
"type": "stdio",
"command": "uvx",
"args": [
"open-notebook-mcp"
],
"env": {
"OPEN_NOTEBOOK_URL": "<OPEN_NOTEBOOK_URL>",
"OPEN_NOTEBOOK_PASSWORD": "<OPEN_NOTEBOOK_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from open-notebook-mcp <команда>
Командой платформы
gemini mcp add -e OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL> -e OPEN_NOTEBOOK_PASSWORD=<OPEN_NOTEBOOK_PASSWORD> open-notebook uvx open-notebook-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from open-notebook-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о open-notebook
Как установить open-notebook в Claude Code?
Выполните в терминале команду claude mcp add open-notebook -e OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL> -e OPEN_NOTEBOOK_PASSWORD=<OPEN_NOTEBOOK_PASSWORD> -- uvx open-notebook-mcp.
Что делает сервер open-notebook?
Он открывает ассистенту доступ к API Open Notebook: позволяет управлять блокнотами, прикреплять веб-страницы или тексты, запускать векторный поиск и сохранять заметки.
Какие параметры нужны для подключения?
Требуется переменная окружения OPEN_NOTEBOOK_URL с адресом запущенного инстанса (например, http://localhost:5055). Если в сервисе настроена защита, также передаётся пароль в OPEN_NOTEBOOK_PASSWORD.
