Chisel Planner

个人规划器，通过 MCP 提供主要代理界面。

状态

首个版本实现了 Bun/Hono 脚手架、按用户划分的 SQLite、迁移、配置、项目/任务/习惯/容量领域、REST、响应式 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 在 127.0.0.1:3000 启动 API，在 127.0.0.1:5173 启动 Vite。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 发现位于 /.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 验证。