Journal Mandala MCP

Это MCP-сервер для прямой записи дневниковых записей в Journal Mandala из Claude.

Используется, когда вы хотите запечатлеть «поток мыслей» в мандале прямо во время разговора.

Что потребуется

• Node.js 20+

• Claude Desktop (или Claude Code)

• API-ключ Journal Mandala (инструкции по получению см. в разделе «Получение API-ключа»)

Установка

Установите глобально через npm.

npm install -g github:takezone/journal-mandala-mcp

Для обновления выполните ту же команду еще раз.

Настройка Claude Desktop

Отредактируйте файл ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

Использование с 1 аккаунтом

{
  "mcpServers": {
    "journal-mandala": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Если нужно переключаться между 2 аккаунтами (personal / work)

{
  "mcpServers": {
    "journal-mandala-personal": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_PERSONAL_KEY"
      }
    },
    "journal-mandala-work": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_WORK_KEY"
      }
    }
  }
}

Они будут видны в Claude как отдельные инструменты. Переключаться можно на естественном языке, например: «запиши в work».

После настройки перезапустите Claude Desktop.

Получение API-ключа

В настоящее время обратитесь к администратору Journal Mandala (@takezone) и сообщите следующее для выпуска ключа:

1. Адрес электронной почты вашего аккаунта Google

2. Название метки (например: alice-personal)

Когда администратор пришлет API-ключ, скопируйте его в JOURNAL_MANDALA_API_KEY в настройках выше.

Примечание: В будущем планируется автоматический выпуск через браузер.

Как использовать

Если вы попросите Claude в ходе разговора «запиши сегодняшние события в дневник», будет вызван инструмент add_journal_entry, и запись будет добавлена в Journal Mandala.

Доступные для записи поля:

• title Заголовок (необязательно)

• event Событие (что произошло)

• thought Мысли (что вы почувствовали)

• entry_date Дата YYYY-MM-DD (по умолчанию — сегодня по JST)

• entry_time Время HH:MM

• tags Массив тегов

• star_rating Оценка от 1 до 5

Хотя бы одно из полей title, event или thought является обязательным.

Дополнительные переменные окружения

• JOURNAL_MANDALA_API_URL — API-эндпоинт (по умолчанию: https://journal-mandala.vercel.app)

Устранение неполадок

• Инструмент не отображается в Claude → Возможно, ошибка синтаксиса JSON в файле конфигурации. Проверьте логи MCP в меню Developer в Claude Desktop.

• Ошибка API 401 → JOURNAL_MANDALA_API_KEY недействителен. Запросите повторный выпуск у администратора.

• Сетевая ошибка → Проверьте статус работы Vercel.

Лицензия

MIT