nuvo-mcp

Дела Nuvo — руками помощника.

MCP-сервер к Nuvo — менеджеру дел, устроенному как область → проект → дело, с чек-листом и тегами. Даёт помощнику двадцать один инструмент: смотреть «Сегодня», заводить и менять дела, дописывать заметки, вести чек-лист, вешать теги, создавать проекты и области.

Сервер ходит в то же HTTP-API, что и приложение, — не в базу. Поэтому он подчиняется правам ключа, всё сделанное видно в приложении сразу и записано в журнал ключа.

Вы:       Что у меня сегодня?
Помощник: → today
          Сегодня три дела:
          • Позвонить в банк · срок 20 октября
          • Забрать посылку
          • Дописать раздел про оплату

Вы:       Дозвонился, привезут в среду. Отметь и запиши.
Помощник: → add_note(3, "Дозвонился, привезут в среду")
          → complete_task(3)
          Готово. В заметке появился абзац с сегодняшней датой.

Запуск за три шага

1. Поднимите Nuvo — приложение слушает http://127.0.0.1:8000.

2. Выдайте ключ — «Настройки → Подключение» → «Выдать ключ». Токен показывается один раз.

3. Подключите к своему помощнику. Пример для Claude Code:

claude mcp add nuvo -s user \
  -e NUVO_TOKEN=nv_ваш_ключ \
  -e NUVO_URL=http://127.0.0.1:8000 \
  -- uvx --from git+https://github.com/darenwhite79/nuvo-mcp.git nuvo-mcp

Спросите: «что у меня сегодня?» — должен ответить списком.

Остальные клиенты — Claude Desktop, Cursor, VS Code, Windsurf, Zed — с готовыми блоками настройки: docs/clients.md.

Нужен uv: brew install uv или curl -LsSf https://astral.sh/uv/install.sh | sh. uvx ставит пакет во временное окружение сам, Python настраивать не надо.

Настройка

Ключ без интерфейса — запросом:

curl -X POST http://127.0.0.1:8000/api/keys \
  -H 'Content-Type: application/json' \
  -d '{"title":"Мой помощник","scopes":"read,create,edit"}'

Права ключа — read, create, edit, delete — ограничивают и помощника: ключ без edit не даст ничего изменить, и отказ помощник увидит словами.

Что умеет

Окончательного удаления у помощника нет намеренно. Корзину чистит человек.

Полные описания, которые видит модель, — в src/nuvo_mcp/tools.py.

Чтобы помощник вёл дела осмысленно

Сервер сам объясняет клиенту правила: «Сегодня» — обещание сделать сегодня, а не пометка важности; срок и день выполнения — разные вещи; перед созданием дела поискать похожее.

Готовые системные подсказки под свои привычки — docs/prompts.md.

Устройство

src/nuvo_mcp/api.py      клиент к HTTP-API и перевод ошибок на человеческий
src/nuvo_mcp/tools.py    инструменты обычными функциями + их описания
src/nuvo_mcp/server.py   регистрация в MCP и запуск по stdio

Зависимости — только mcp и httpx: пакет самодостаточен и ничего не знает о приложении, кроме адреса.

Разработка

uv sync
uv run pytest        # без сети и без бэкенда: HTTP подменён транспортом httpx
uv run ruff check .
uv run ruff format --check .

Работу против живого API проверяют тесты приложения — backend/tests/test_mcp.py в nuvo-task-manager.

Лицензия

MIT.