Chisel Planner

Persönlicher Planer mit einer Hauptschnittstelle für Agenten über MCP.

Status

Der erste Entwurf implementiert das Bun/Hono-Gerüst, SQLite pro Benutzer, Migrationen, Konfiguration, die Domäne für Projekte/Aufgaben/Gewohnheiten/Kapazität, REST, einen responsiven Web-Ansatz und einen authentifizierten MCP-Server. OAuth 2.1 wird mit Better Auth gelöst: PKCE, DCR, geschlossener Login, Websitzungen, JWT und an die MCP-Ressource gebundene Tokens. Die UI wird weiterhin auf Grundlage von Figma weiterentwickelt, und CIMD bleibt für eine spätere Phase.

Related MCP server: ticktick-sdk

Anforderungen

• Bun 1.3+

• Docker optional

Entwicklung

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

bun run dev startet die API auf 127.0.0.1:3000 und Vite auf 127.0.0.1:5173. Die Webanwendung befindet sich in der Produktion unter /app/today und nutzt während der Entwicklung einen Proxy zur API.

Erstelle den ersten Benutzer mit der geschlossenen Registrierung:

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

Der erste Web-Ansatz ermöglicht es, sich anzumelden, den Tag zu überprüfen, Aufgaben und Gewohnheiten abzuschließen, Projekte zu erstellen und die MCP-Verbindungs-URL zu kopieren. Die Ansicht ist Mobile-First konzipiert und passt sich auf dem Desktop mit einer Sidebar an.

Schnelle Überprüfung:

curl http://127.0.0.1:3000/health

Der OAuth-Discovery ist unter /.well-known/oauth-authorization-server verfügbar und die Metadaten der Ressource unter /.well-known/oauth-protected-resource/mcp. /mcp erfordert ein Access-Token mit dem Scope mcp:tools.

Um den MCP-Server zu inspizieren, wenn er läuft, verwende einen Client, der den OAuth-2.1-Flow unterstützt:

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

Befehle

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

Die persistenten Daten befinden sich in DATA_DIR: system.db und eine separate Datenbank pro Benutzer in users/.

Sicherheit in der Entwicklung

Konfiguriere in Produktion immer BETTER_AUTH_SECRET, AUTH_BASE_URL und MCP_RESOURCE mit den tatsächlichen öffentlichen Werten. Verwende HTTPS, bewahre das /data-Volume auf und setze eine einzelne Replik ein, um den SQLite-Zustand nicht zu teilen. Lokal werden Host- und Origin-Validierungen über den offiziellen Hono-Adapter angewendet.