# File Time Search MCP — PRD 문서 묶음
> **For AI Agents**: Please refer to **[AI_CONTEXT.md](AI_CONTEXT.md)** first for a consolidated overview, critical constraints, and documentation map.
이 폴더는 **파일의 최근 수정 날짜(Modified Time)** 및 **생성 날짜(Created/Birth Time)** 기준으로 검색할 수 있는 MCP(Model Context Protocol) 서버를 만들기 위한 PRD 문서입니다.
- 최신 MCP 스펙(Protocol Revision **2025-11-25**) 기준으로 작성했습니다.
- 본 PRD는 “무엇을 만들 것인지(요구사항/계약/API)”를 정의합니다. 구현 언어(TypeScript/Java 등)는 강제하지 않습니다.
## 문서 구성
- [PRD-FileTimeSearch-MCP.md](PRD-FileTimeSearch-MCP.md): 제품 요구사항(PRD) 본문
- [PRD-API.md](PRD-API.md): MCP Tools/API 계약(입력/출력 스키마, 에러 정책, 예시)
- [PRD-ImplementationNotes.md](PRD-ImplementationNotes.md): 구현 시 고려사항(Windows 생성시간, 보안, 성능, 경계 조건)
- [PRD-TestPlan.md](PRD-TestPlan.md): 테스트/검증 계획 및 수용 기준
- [PRD-Language-Recommendation.md](PRD-Language-Recommendation.md): 언어/SDK 추천 리포트
- [PRD-Distribution-Review.md](PRD-Distribution-Review.md): 외부 배포 관점 언어 검토 리포트
## 문서 리뷰
- [Docs-Sufficiency-Review.md](Docs-Sufficiency-Review.md): 다른 AI Agent 관점의 문서 충분성/미결정 사항 점검
## 보충 문서(v0 정책 고정)
- [PRD-v0-Policy.md](PRD-v0-Policy.md): 미결정 사항을 v0 정책으로 고정(allowRoots/path/glob/cursor/정렬/제한)
- [PRD-Defaults-v0.md](PRD-Defaults-v0.md): v0 기본값/상한(guardrails) 테이블
- [PRD-ErrorCodes-v0.md](PRD-ErrorCodes-v0.md): tool 실행 에러 코드/메시지 표준
- [PRD-Examples-v0.md](PRD-Examples-v0.md): cursor 포함 예시/unknown time/디렉터리 포함 예시
## TypeScript 구현 가이드
- [TS-Project-Guide.md](TS-Project-Guide.md): TypeScript 프로젝트 구성/구현 가이드
- [TS-Runbook.md](TS-Runbook.md): 실행/테스트/Inspector 런북
- [TS-Implementation-Plan.md](TS-Implementation-Plan.md): TypeScript 구현 마일스톤/체크리스트
> v0 주의: `from/to`는 ISO 8601 date-time 문자열만 허용합니다([PRD-v0-Policy.md](PRD-v0-Policy.md)). 실행 전 `ALLOW_ROOTS` 설정은 [TS-Runbook.md](TS-Runbook.md)의 “0. v0 환경변수 설정”을 참고하세요.
## 용어
- **mtime**: 파일의 “마지막 수정 시간”(last modified time)
- **ctime(Windows)**: Windows에서 파일의 “생성 시간”(creation time). Linux/macOS의 ctime과 의미가 다릅니다.
- **birth time**: 파일 생성 시각(일부 OS/파일시스템에서만 지원)
## 스펙 기준
- MCP Specification: https://modelcontextprotocol.io/specification/latest
- Tools (Server Feature): https://modelcontextprotocol.io/specification/2025-11-25/server/tools
- Schema Reference (tools/list, tools/call 등): https://modelcontextprotocol.io/specification/2025-11-25/schema
