Chisel Planner

Персональный планировщик с основным интерфейсом для агентов через MCP.

Статус

Первый срез реализует скаффолд Bun/Hono, SQLite для каждого пользователя, миграции, конфигурацию, домен проектов/задач/привычек/ёмкости, REST, адаптивную веб-реализацию и аутентифицированный MCP-сервер. OAuth 2.1 решается с помощью Better Auth: PKCE, DCR, закрытая регистрация, веб-сессии, JWT и токены, привязанные к ресурсу MCP. UI продолжит развиваться из Figma, а CIMD откладывается на более поздний этап.

Related MCP server: ticktick-sdk

Требования

• Bun 1.3+

• Docker (необязательно)

Разработка

bun install
cp .env.example .env
bun run dev

bun run dev поднимает API на 127.0.0.1:3000 и Vite на 127.0.0.1:5173. Веб-приложение живёт в /app/today в продакшене и использует прокси к API во время разработки.

Создайте первого пользователя с помощью закрытой регистрации:

AUTH_BOOTSTRAP_EMAIL=owner@example.com \
AUTH_BOOTSTRAP_PASSWORD='una-password-de-12-caracteres' \
bun run auth:bootstrap

Первая веб-реализация позволяет войти в систему, просмотреть день, выполнять задачи и привычки, создавать проекты и копировать URL подключения MCP. Дизайн задуман mobile-first и адаптируется для десктопа с боковой панелью.

Быстрая проверка:

curl http://127.0.0.1:3000/health

OAuth discovery доступен в /.well-known/oauth-authorization-server, а метаданные ресурса — в /.well-known/oauth-protected-resource/mcp. /mcp требует access token со scope mcp:tools.

Чтобы инспектировать MCP-сервер, когда он запущен, используйте клиент, поддерживающий поток OAuth 2.1:

npx @modelcontextprotocol/inspector --cli http://127.0.0.1:3000/mcp --transport http --method server/discover

Команды

bun run typecheck
bun test
bun run build
bun run migrate:all
bun run auth:bootstrap

Постоянная информация хранится в DATA_DIR: system.db и отдельная база для каждого пользователя в users/.

Безопасность разработки

Всегда настраивайте BETTER_AUTH_SECRET, AUTH_BASE_URL и MCP_RESOURCE с реальными публичными значениями в продакшене. Используйте HTTPS, сохраняйте том /data и разворачивайте одну реплику, чтобы не разделять состояние SQLite. Локально применяются проверки Host и Origin через официальный адаптер Hono.