thoughtbox

thoughtbox — MCP-сервер сообщества (автор — Kastalien-Research). Расширенные рассуждения со структурированными процессами и сохранением. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Kastalien-Research
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

Выполняет JavaScript от модели через SDK и блокноты; хранит рассуждения на диске или в Supabase; HTTP-сервер слушает все интерфейсы.

Настройка клиентов

vscode
{
    "code": "{\n  \"servers\": {\n    \"thoughtbox\": {\n      \"url\": \"http://localhost:1731/mcp\"\n    }\n  }\n}",
    "file": ".vscode/mcp.json",
    "lang": "json",
    "verified": "docs"
}

Что умеет

Thoughtbox — проект Kastalien Research: MCP-сервер для структурированных рассуждений нескольких агентов с возможностью аудита. Каждый шаг записывается как структурированная «мысль» в постоянный журнал рассуждений, а веб-приложение-компаньон позволяет смотреть и разбирать этот журнал. Сейчас сервер оптимизирован для Claude Code; поддержка других клиентов в работе.

Режим кода — всего два инструмента:

  • thoughtbox_search — модель пишет JavaScript-запрос к каталогу операций, промптов и ресурсов.
  • thoughtbox_execute — модель пишет JavaScript с SDK tb и связывает операции: мысли, сессии, знания, блокноты, хаб, наблюдаемость.

Такой подход заменяет регистрацию отдельного инструмента на каждую операцию и не раздувает контекст.

Совместная работа агентов (Hub). Агенты регистрируются с ролями (MANAGER, ARCHITECT, DEBUGGER, SECURITY, RESEARCHER, REVIEWER), вступают в общие рабочие пространства и проходят цикл: создать задачу, взять её, работать, предложить решение, пройти рецензию, слить и прийти к консенсусу. Примитивы — задача, предложение, консенсус и канал; всего 28 операций.

Аудируемые рассуждения. Каждая мысль — пронумерованный узел графа с меткой времени и связями с предыдущими, который сохраняется между сессиями. Поддерживаются рассуждения вперёд, назад от цели, ветвление на параллельные варианты и пересмотр ранних выводов; у мыслей есть семантические типы (рассуждение, рамка решения, отчёт о действии и др.).

Наблюдаемость. Веб-интерфейс Observatory на http://localhost:1729 показывает граф мыслей в реальном времени, ветки, детали узлов и анализ сессий. В комплекте — трассировка OpenTelemetry, метрики Prometheus и дашборды Grafana.

Знания и блокноты. Граф знаний с типизированными сущностями и связями и настройками видимости, а также блокноты с исполняемым кодом JavaScript и TypeScript в изолированных средах.

Кому подойдёт

  • Командам, строящим мультиагентные системы, где важно понимать, как агенты пришли к выводу.
  • Пользователям Claude Code, которым нужны структурированные рассуждения с историей.

Похожие серверы — в категории знания и память.

Установка

Сервер работает в Docker: клонируйте репозиторий и выполните docker compose up --build. MCP-сервер слушает порт 1731, Observatory — 1729. Хранилище по умолчанию — файлы в ~/.thoughtbox; также доступны хранение в памяти и Supabase (SUPABASE_URL и SUPABASE_SERVICE_ROLE_KEY). Для разработки нужен Node.js 22+.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "thoughtbox": {
      "url": "http://localhost:1731/mcp"
    }
  }
}

Для Claude Code блок добавляют в ~/.claude/settings.json или .claude/settings.json проекта; для трассировки можно подключаться через порт 4000. Для VS Code и Cline — .vscode/mcp.json или настройки MCP.

Проверка

Откройте Observatory и попросите агента разобрать задачу по шагам — мысли должны появляться на графе.

Примеры задач

Спланируй архитектуру от цели «10 тысяч запросов в секунду» назад к текущему состоянию.
Сравни два варианта базы данных отдельными ветками рассуждений и подведи итог.

Риски

  • Выполнение JavaScript, который пишет модель, через thoughtbox_execute и блокноты.
  • Хранение рассуждений на диске или в Supabase; ключ сервисной роли Supabase держите в секрете.
  • Сетевой доступ. Сервер по умолчанию слушает все интерфейсы (HOST=0.0.0.0) — ограничьте доступ к портам.

Частые вопросы

Сколько инструментов у сервера?

Два: поиск по каталогу и выполнение кода.

Где смотреть рассуждения?

В веб-интерфейсе Observatory.

Работает ли с другими клиентами?

Сервер оптимизирован для Claude Code, с остальными возможны проблемы.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

paperclip

Оценки популярности хип-хоп исполнителей по четырём культурным измерениям.

Риск: medium Лицензия: MIT ★ 114 818

Coder

Управление рабочими пространствами, шаблонами и облачными средами разработки Coder.

Риск: medium Лицензия: AGPL-3.0 ★ 17 363

Источники