til-server 0.1.0__tar.gz

til_server-0.1.0/.claude/settings.local.json

@@ -0,0 +1,42 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__context7__resolve-library-id",
+      "mcp__context7__query-docs",
+      "Bash(python3 -m pip install:*)",
+      "Bash(python3:*)",
+      "Bash(source:*)",
+      "Bash(pip install:*)",
+      "Bash(pip show:*)",
+      "Bash(git init:*)",
+      "Bash(git branch:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(tmux:*)",
+      "Bash(claude:*)",
+      "Bash(chmod:*)",
+      "Bash(/Users/ram/programming/vibecoding/mcp/launch-team.sh)",
+      "Bash(open:*)",
+      "Bash(osascript -e 'tell application \"\"Terminal\"\" to do script \"\"tmux attach -t mcp-learning\"\"')",
+      "Bash(gh auth status:*)",
+      "Bash(gh repo create:*)",
+      "Bash(for i in 0 1 2 3)",
+      "Bash(do echo \"=== PANE $i ===\")",
+      "Bash(done)",
+      "Bash(env -u CLAUDECODE claude -p \"hello, 간단히 답해\")",
+      "Bash(env -u CLAUDECODE claude:*)",
+      "Bash(osascript -e 'tell application \"\"Terminal\"\" to do script \"\"./launch-team.sh && tmux attach -t mcp-learning\"\"')",
+      "Bash(osascript -e 'tell application \"\"Terminal\"\" to do script \"\"bash launch-team.sh && tmux attach -t mcp-learning\"\"')",
+      "Bash(osascript -e 'tell application \"\"Terminal\"\" to do script \"\"bash /Users/ram/programming/vibecoding/mcp/launch-team.sh && tmux attach -t mcp-learning\"\"')",
+      "Bash(pkill -f \"claude -p --dangerously\")",
+      "Bash(osascript -e 'tell application \"\"Terminal\"\" to do script \"\"bash /Users/ram/programming/vibecoding/mcp/launch-team.sh\"\"')",
+      "Bash(pkill:*)",
+      "WebFetch(domain:www.youtube.com)",
+      "WebSearch",
+      "Bash(ls:*)",
+      "Bash(brew install:*)",
+      "Bash(echo '' >> ~/.zshrc && echo '# 클립보드 스크린샷 → 파일 저장' >> ~/.zshrc && echo 'alias ss=\"pngpaste /tmp/ss.png && echo /tmp/ss.png\"' >> ~/.zshrc)",
+      "Bash(git:*)"
+    ]
+  }
+}

til_server-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.idea/
+venv/
+__pycache__/
+*.pyc
+.env
+.DS_Store
+data/*.db

til_server-0.1.0/.worklogs/.snapshot

@@ -0,0 +1 @@
+{"timestamp": 1771813721, "totalTokens": 36000839, "totalCost": 21.744676499999986}

til_server-0.1.0/.worklogs/2026-02-21.md

@@ -0,0 +1,79 @@
+# Worklog: mcp — 2026-02-21
+
+---
+
+## 17:37 (auto)
+
+### 변경된 파일 (2개)
+```
+launch-team.sh
+start-team.sh
+```
+
+### 변경 통계
+```
+ launch-team.sh | 17 ++++++-----------
+ start-team.sh  | 31 +++++++++++++++++++++++++++++++
+ 2 files changed, 37 insertions(+), 11 deletions(-)
+```
+
+---
+
+## 17:37 (auto)
+
+### 변경된 파일 (1개)
+```
+docs/explanation.md
+```
+
+### 변경 통계
+```
+ docs/explanation.md | 317 ++++++++++++++++++++++++++++++++++++++++++++++++++++
+ 1 file changed, 317 insertions(+)
+```
+
+---
+
+## 17:50 (auto)
+
+### 변경된 파일 (1개)
+```
+.gitignore
+```
+
+### 변경 통계
+```
+ .gitignore | 1 +
+ 1 file changed, 1 insertion(+)
+```
+
+---
+
+## 17:53 (auto)
+
+### 변경된 파일 (1개)
+```
+README.md
+```
+
+### 변경 통계
+```
+ README.md | 372 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+ 1 file changed, 372 insertions(+)
+```
+
+---
+
+## 17:54 (auto)
+
+### 변경된 파일 (1개)
+```
+README.md
+```
+
+### 변경 통계
+```
+ README.md | 2 ++
+ 1 file changed, 2 insertions(+)
+```
+

til_server-0.1.0/.worklogs/2026-02-23.md

@@ -0,0 +1,224 @@
+# Worklog: mcp — 2026-02-23
+
+---
+
+## 10:44 (auto)
+
+### 작업 내용
+- feat: 스토리지를 SQLite에서 로컬 마크다운 파일로 전환
+- - storage.py 신규 작성: data/tils/YYYY-MM-DD-{slug}.md 파일 기반 CRUD
+- - python-frontmatter 라이브러리로 YAML frontmatter 처리
+- - tools.py: save_discussion_recap tool 추가 (저장 후 git commit/push 자동 실행)
+- - prompts.py: discussion_recap 프롬프트 추가
+- - resources.py, server.py: db 모듈 → storage 모듈로 교체
+
+### 변경 파일
+- `requirements.txt`
+- `src/til_server/prompts.py`
+- `src/til_server/resources.py`
+- `src/til_server/server.py`
+- `src/til_server/storage.py`
+- `src/til_server/tools.py`
+
+---
+
+## 10:49 (auto)
+
+### 작업 내용
+- feat: TIL_REPO_PATH 환경변수로 저장 레포 분리 지원
+- MCP 서버 등록 시 TIL_REPO_PATH를 주입하면
+- 서버 코드와 데이터 레포를 분리할 수 있다.
+
+### 변경 파일
+- `src/til_server/storage.py`
+- `src/til_server/tools.py`
+
+---
+
+## 10:51 (auto)
+
+### 작업 내용
+- chore: pyproject.toml 추가 및 til-server CLI entry point 설정
+- uvx로 설치 없이 바로 실행 가능하도록 패키지 구성
+
+### 변경 파일
+- `pyproject.toml`
+- `src/til_server/server.py`
+
+---
+
+## 11:01 (auto)
+
+### 작업 내용
+- refactor: save_discussion_recap 제거, create_til로 통합
+- 두 툴의 역할이 중복되어 create_til 하나로 통합.
+- docstring에 대화 요약 저장 용도도 명시.
+
+### 변경 파일
+- `src/til_server/prompts.py`
+- `src/til_server/tools.py`
+
+---
+
+## 11:04 (auto)
+
+### 작업 내용
+- docs: README 전면 재작성 — 설치 가이드 및 기능 정리
+- uvx 기반 설치, Windows 포함, GitHub 저장소 방식으로 업데이트
+
+### 변경 파일
+- `README.md`
+
+---
+
+## 11:09 (auto)
+
+### 작업 내용
+- feat: GitHub API 기반 TIL 저장소 모듈 추가
+- urllib.request만 사용해 외부 의존성 없이 GitHub contents API로
+- TIL 마크다운 파일 CRUD 구현. GITHUB_TOKEN 또는 gh auth token으로
+- 인증, TIL_GITHUB_REPO 또는 자동 감지로 레포 설정.
+
+### 변경 파일
+- `src/til_server/github_storage.py`
+
+---
+
+## 11:10 (auto)
+
+### 작업 내용
+- refactor: storage.py를 github_storage 래퍼로 교체, tools.py 정리
+- 기존 import 경로 유지를 위해 storage.py를 github_storage 재노출 모듈로
+- 변환. tools.py에서 로컬 파일 경로(_TIL_REPO, Path) 관련 코드 제거.
+
+### 변경 파일
+- `src/til_server/storage.py`
+- `src/til_server/tools.py`
+
+---
+
+## 11:16
+
+### 요청사항
+- til-server MCP가 Local scope로 등록된 이유 파악 및 user scope 이동
+- README.md에 `-s user` 플래그 설치 안내 추가
+
+### 작업 내용
+- `~/.claude.json`에서 til-server를 project scope → user scope로 이동
+- README.md 모든 `claude mcp add` 명령에 `-s user` 플래그 추가
+- 주의사항 안내 문구 추가
+
+### 작업 내용
+- docs: MCP 등록 명령에 -s user 플래그 추가
+- 모든 프로젝트에서 사용 가능하도록 user scope 설치 방법으로 안내.
+- 플래그 없이 설치 시 project scope에 등록되는 점도 명시.
+
+### 변경 파일
+- `README.md`: `claude mcp add` 명령에 `-s user` 플래그 및 안내 문구 추가
+
+### 토큰 사용량
+- 모델: claude-sonnet-4-6
+- 이번 작업: 34,463,169 토큰 / $21.07 (전체 누적, 스냅샷 없음)
+- 소요 시간: 측정 불가
+- 일일 누적: 34,463,169 토큰 / $21.07
+
+---
+
+## 11:19
+
+### 요청사항
+- MCP 설명/기능 최신화 여부 확인 및 수정
+
+### 작업 내용
+- server.py, resources.py 주석 4곳이 실제 구현과 불일치함을 확인
+- storage 설명 "파일 기반" → "GitHub API 기반", discussion_recap 툴 제거, 디렉토리 초기화 설명 수정, 이번 주(월~일) → 최근 7일간 수정
+
+### 작업 내용
+- docs: MCP 설명 주석 최신화 (GitHub API 기반으로 수정)
+- storage 설명 "파일 기반" → "GitHub API 기반",
+- discussion_recap 툴 목록에서 제거 (프롬프트로만 존재),
+- 디렉토리 초기화 주석 수정, 이번 주(월~일) → 최근 7일간
+
+### 변경 파일
+- `src/til_server/server.py`: storage 설명, tools 목록, 초기화 주석 수정
+- `src/til_server/resources.py`: list_week_tils 설명 "이번 주(월~일)" → "최근 7일간"
+
+### 토큰 사용량
+- 모델: claude-sonnet-4-6
+- 이번 작업: 1,537,670 토큰 / $0.67
+- 소요 시간: 측정 불가
+- 일일 누적: 36,000,839 토큰 / $21.74
+
+---
+
+## 11:22
+
+### 요청사항
+- README.md 최신화 여부 확인 및 수정
+
+### 작업 내용
+- README Resources 표에서 `til://list/week` 설명 "이번 주 기록" → "최근 7일 기록"으로 수정
+
+### 작업 내용
+- docs: README til://list/week 설명 최신화
+- "이번 주 기록" → "최근 7일 기록" (실제 구현과 일치)
+
+### 변경 파일
+- `README.md`: `til://list/week` 설명 최신화
+
+### 토큰 사용량
+- 모델: claude-sonnet-4-6
+- 이번 작업: 데이터 없음
+- 소요 시간: 1분
+- 일일 누적: 데이터 없음
+
+---
+
+## 11:27
+
+### 요청사항
+- ENABLE_TOOL_SEARCH로 인해 TIL MCP 툴이 자동 사용 안 되는 문제 해결
+
+### 작업 내용
+- FastMCP `instructions` 파라미터로 서버 목적 명시 (공식 문서 확인 후 적용)
+- 기록 요청 시 create_til 사용, 조회는 til://list, 검색은 search_til 안내 포함
+
+### 작업 내용
+- feat: FastMCP instructions 추가로 TIL 기록 자동 유도
+- ENABLE_TOOL_SEARCH=true 환경에서 deferred 툴이 자동 호출되지 않는 문제 해결.
+- 서버 instructions로 create_til/search_til/til://list 사용 시점을 명시.
+
+### 변경 파일
+- `src/til_server/server.py`: FastMCP 생성 시 instructions 파라미터 추가
+
+### 토큰 사용량
+- 모델: claude-sonnet-4-6
+- 이번 작업: 데이터 없음
+- 소요 시간: 2분
+- 일일 누적: 데이터 없음
+
+---
+
+## 11:28
+
+### 요청사항
+- 서버 업데이트 시 다른 컴퓨터에서 자동 반영되도록 설치 명령 개선
+
+### 작업 내용
+- `uvx --refresh` 플래그 추가로 Claude Code 시작 시마다 최신 버전 자동 반영
+- README 설치 명령 3곳 모두 업데이트
+
+### 작업 내용
+- docs: uvx --refresh 플래그 추가로 자동 업데이트 지원
+- Claude Code 시작 시마다 최신 서버 버전을 자동으로 받아오도록
+- 설치 명령 전체에 --refresh 플래그 추가.
+
+### 변경 파일
+- `README.md`: uvx 명령에 `--refresh` 플래그 추가 (3곳)
+
+### 토큰 사용량
+- 모델: claude-sonnet-4-6
+- 이번 작업: 데이터 없음
+- 소요 시간: 1분
+- 일일 누적: 데이터 없음
+

til_server-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: til-server
+Version: 0.1.0
+Summary: TIL 지식 관리 MCP 서버
+Requires-Python: >=3.11
+Requires-Dist: mcp>=1.26.0
+Requires-Dist: python-frontmatter>=1.1.0

til_server-0.1.0/README.md

@@ -0,0 +1,166 @@
+# TIL MCP 서버
+
+> **GitHub**: https://github.com/kangraemin/mcp-learning
+
+학습 내용(TIL: Today I Learned)과 대화 중 논의한 것들을 기록하고, 검색하고, 회고해주는 MCP 서버.
+
+Claude에게 자연어로 말하면 알아서 GitHub에 마크다운 파일로 저장한다.
+
+---
+
+## 이런 게 됩니다
+
+| 말하면 | Claude가 하는 일 |
+|--------|-----------------|
+| "오늘 Python 배운 거 기록해줘" | TIL 작성해서 GitHub에 저장 |
+| "방금 토큰 최적화 논의한 거 정리해줘" | 대화 내용 요약해서 GitHub에 저장 |
+| "이번 주 뭐 배웠지?" | 이번 주 기록 꺼내서 보여줌 |
+| "MCP 관련 기록 찾아줘" | 키워드로 검색해서 결과 보여줌 |
+| "주간 회고 써줘" | 이번 주 기록 분석해서 회고문 작성 |
+
+---
+
+## 설치
+
+### 사전 준비
+
+- [Claude Code](https://claude.ai/claude-code) 설치
+- [gh CLI](https://cli.github.com) 설치 + 로그인
+
+```bash
+# gh CLI 설치 후
+gh auth login
+```
+
+> **Windows**: [gh CLI Windows 설치](https://github.com/cli/cli/releases/latest) 에서 `.msi` 다운로드
+
+### uv 설치
+
+**macOS / Linux**
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+**Windows (PowerShell)**
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### MCP 서버 등록
+
+```bash
+claude mcp add -s user --transport stdio til-server \
+  -- uvx --refresh --from git+https://github.com/kangraemin/mcp-learning til-server
+```
+
+**Windows (PowerShell)**
+```powershell
+claude mcp add -s user --transport stdio til-server `
+  -- uvx --refresh --from git+https://github.com/kangraemin/mcp-learning til-server
+```
+
+> `-s user` 없이 실행하면 현재 프로젝트에만 등록됩니다. 모든 프로젝트에서 쓰려면 `-s user`를 붙이세요.
+
+Claude Code를 재시작하면 끝.
+
+---
+
+## 첫 사용
+
+Claude Code에서 아무거나 기록해보자:
+
+```
+오늘 배운 거 기록해줘
+```
+
+처음 사용 시 `{GitHub유저명}/til-notes` 레포가 없으면 자동으로 생성된다.
+
+이후 모든 TIL은 해당 레포에 마크다운 파일로 저장된다:
+```
+til-notes/
+  tils/
+    2026-02-23-python-.md
+    2026-02-23-mcp-.md
+```
+
+---
+
+## 다른 레포에 저장하고 싶다면
+
+```bash
+claude mcp add -s user --transport stdio til-server \
+  -e TIL_GITHUB_REPO=username/my-notes \
+  -- uvx --refresh --from git+https://github.com/kangraemin/mcp-learning til-server
+```
+
+gh CLI 없이 토큰으로 직접 인증하려면:
+```bash
+claude mcp add -s user --transport stdio til-server \
+  -e TIL_GITHUB_REPO=username/my-notes \
+  -e GITHUB_TOKEN=ghp_xxxx \
+  -- uvx --refresh --from git+https://github.com/kangraemin/mcp-learning til-server
+```
+
+---
+
+## 동작 원리
+
+```
+사용자: "Python 배운 거 기록해줘"
+    ↓
+Claude Code → Claude AI (어떤 도구 쓸지 판단)
+    ↓
+Claude AI → "create_til 써줘"
+    ↓
+Claude Code → TIL MCP 서버 (로컬에서 실행 중)
+    ↓
+TIL MCP 서버 → GitHub API → til-notes 레포에 .md 파일 생성
+```
+
+인터넷 구간: Claude Code ↔ Anthropic AI 서버
+로컬 구간: Claude Code ↔ MCP 서버
+저장소: GitHub 레포 (마크다운 파일)
+
+---
+
+## 제공하는 기능
+
+### Tools (행동)
+| 이름 | 설명 |
+|------|------|
+| `create_til` | TIL 작성 및 대화 내용 요약 저장 |
+| `update_til` | 기존 TIL 수정 |
+| `delete_til` | TIL 삭제 |
+| `search_til` | 키워드/태그/카테고리로 검색 |
+| `add_tag` | 태그 추가 |
+| `export_til` | Markdown으로 내보내기 |
+
+### Resources (조회)
+| URI | 설명 |
+|-----|------|
+| `til://list` | 전체 목록 |
+| `til://list/today` | 오늘 기록 |
+| `til://list/week` | 최근 7일 기록 |
+| `til://{id}` | 특정 TIL 상세 |
+| `til://tags` | 태그 목록 |
+| `til://stats` | 학습 통계 |
+
+### Prompts (템플릿)
+| 이름 | 설명 |
+|------|------|
+| `write_til` | TIL 작성 가이드 |
+| `weekly_review` | 주간 회고 생성 |
+| `suggest_topics` | 다음 학습 주제 추천 |
+| `summarize_learnings` | 기간별 학습 요약 |
+| `discussion_recap` | 대화 논의 내용 정리 |
+
+---
+
+## 기술 스택
+
+| 항목 | 내용 |
+|------|------|
+| 언어 | Python 3.11+ |
+| MCP 프레임워크 | FastMCP |
+| 저장소 | GitHub (마크다운 파일) |
+| 전송 방식 | stdio |