log-reflect-mcp

log-reflect-mcp는 개인 기록 시스템을 위한 로컬 우선 MCP 서버입니다. AI 클라이언트에게 Markdown 기록을 캡처하고 검색할 수 있는 작고 명확한 인터페이스를 제공하면서, 기록은 별도의 저장소에 보관합니다.

이 서버는 log-reflect-practice에서 사용하는 디렉터리 규칙과 함께 작동하도록 설계되었습니다:

daily/
├── journal/{YYYY}/{YYYYMM}/
└── inputs/{YYYY}/{YYYYMM}/
practices/

현재 범위

첫 번째 버전은 의도적으로 네 가지 도구만 노출합니다:

• capture_journal: 개인 저널 조각을 생성하거나 추가합니다.

• capture_input: 외부 입력을 Markdown 노트로 저장합니다.

• get_records_by_date_range: 검토를 위해 저널 및 입력 기록을 검색합니다.

• search_records: 기록 내용을 검색합니다.

MCP 서버는 접근과 저장을 처리합니다. 판단은 Agent Skills의 책임으로 남습니다: 저널을 얼마나 가볍게 편집할지, 입력 노트에 무엇을 넣을지, 7일을 어떻게 검토할지, 그리고 반복되는 주제가 언제 Practice가 될 준비가 되었는지.

Related MCP server: ai-journal

안전 경계

• 소스 저장소에는 개인 기록이나 자격 증명이 포함되어 있지 않습니다.

• 서버는 daily/journal/ 및 daily/inputs/만 읽을 수 있습니다.

• 새 기록은 해당 두 디렉터리 안에만 작성됩니다.

• 기존 입력 파일은 절대 조용히 덮어쓰지 않습니다.

• 특정 날짜에 저널 파일이 두 개 이상 존재하면 추측하지 않고 쓰기를 중지합니다.

설정

요구 사항: Node.js 22 이상.

npm install
cp .env.example .env

기록 저장소의 절대 경로를 설정하세요:

RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice

stdio 서버를 빌드하고 시작하세요:

npm run build
RECORDS_REPO_PATH=/absolute/path/to/log-reflect-practice npm start

클라이언트 구성 예시

빌드 후 MCP 클라이언트를 컴파일된 서버에 연결하세요:

{
  "mcpServers": {
    "log-reflect": {
      "command": "node",
      "args": ["/absolute/path/to/log-reflect-mcp/dist/src/server.js"],
      "env": {
        "RECORDS_REPO_PATH": "/absolute/path/to/log-reflect-practice",
        "RECORDS_TIME_ZONE": "America/Los_Angeles"
      }
    }
  }
}

개발

npm run check
npm test

도구를 대화형으로 검사하려면:

npx @modelcontextprotocol/inspector node dist/src/server.js

로드맵

• 개별 기록을 읽기 위한 MCP 리소스를 추가합니다.

• 판단을 저장 코드로 옮기지 않고 검토 및 Practice 개발 프롬프트를 추가합니다.

• 옵트인 Git 커밋 워크플로를 추가합니다.

• GitHub 기반 저장소 어댑터를 추가합니다.

• 로컬 워크플로가 안정화된 후에만 Streamable HTTP 및 OAuth를 추가합니다.