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는 127.0.0.1:3000에서 API를, 127.0.0.1:5173에서 Vite를 실행합니다. 웹 애플리케이션은 프로덕션에서 /app/today에 있으며 개발 중에는 API에 대한 프록시를 사용합니다.

폐쇄형 등록으로 첫 번째 사용자를 생성합니다:

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

첫 번째 웹 접근 방식은 로그인, 하루 확인, 작업 및 습관 완료, 프로젝트 생성, 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 검증이 적용됩니다.