Chisel Planner

MCP によってエージェントを主インターフェースとして用いる個人用プランナーです。

現状

最初の実装では、Bun/Hono の土台、ユーザーごとの SQLite、マイグレーション、設定、プロジェクト・タスク・習慣・キャパシティのドメイン、REST API、レスポンシブな Web アプリ、認証付き MCP サーバーを実装しています。OAuth 2.1 は Better Auth により解決しています。PKCE、DCR、限定登録、Web セッション、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 で起動します。Web アプリは本番では /app/today に配置され、開発時は API へのプロキシを使用します。

限定登録で最初のユーザーを作成します：

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

最初の Web 実装では、サインイン、その日のレビュー、タスクと習慣の完了、プロジェクトの作成、MCP 接続 URL のコピーができます。画面はモバイルファーストで設計されており、デスクトップではサイドバー付きのレイアウトに適応します。

クイックチェック：

curl http://127.0.0.1:3000/health

OAuth の discovery は /.well-known/oauth-authorization-server で提供され、リソースのメタデータは /.well-known/oauth-protected-resource/mcp にあります。/mcp へのアクセスには 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 の状態を分割しないよう単一レプリカでデプロイします。ローカルでは Hono 公式のアダプタにより Host と Origin のバリデーションが適用されます。