Work Note MCP Server

Claude와 연동해서 주간업무 보고서를 자동으로 작성하는 MCP 서버.

왜 만들었나

매주 작성하는 주간업무 보고서를 Claude로 자동화하려고 서브 에이전트를 만들었는데, 템플릿 준수율이 85-90% 정도밖에 안 됐다. Claude가 계속 템플릿을 "개선"하려고 해서 MCP 프로토콜로 전환했더니 100% 준수율을 달성했다.

Related MCP server: Weekly Report MCP Server

핵심 기능

업무노트 작성: task(상세작업)와 issue(오류해결) 구분해서 작성
템플릿 강제: JSON Schema로 입력 검증해서 형식 보장
자동 파일 관리: 주간업무 문서 알아서 찾아서 추가
백업/롤백: 파일 작업 실패하면 자동으로 복구

설치

# 프로젝트 클론 git clone [repository-url] cd work-note # 가상환경 (권장) python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate # 패키지 설치 pip install -r requirements.txt

실행

python main.py

Claude Desktop 연동

설정 파일 위치:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "work-note": { "command": "python", "args": ["/path/to/work-note/main.py"], "env": { "PYTHONPATH": "/path/to/work-note" } } } }

사용법

나: "오늘 정산 버그 수정한 거 업무노트로 정리해줘" Claude: [MCP 서버 호출] 결과: "✅ 저장됨: ~/Documents/sync/오프너드/주간업무/1월 3주.md"

제공하는 도구들

도구	하는 일
create_work_note	업무노트 작성하고 파일에 저장
analyze_conversation	대화 내용 분석해서 JSON으로 변환
list_weekly_notes	이번 주 작성한 노트 목록 보기
get_statistics	작성 통계 확인

프로젝트 구조

work-note/ ├── main.py # 메인 서버 ├── src/ │ ├── server.py # MCP 서버 핵심 로직 │ ├── tools.py # 도구 구현 │ ├── schemas.py # JSON Schema 정의 │ ├── templates.py # 노트 템플릿 │ └── utils.py # 파일 작업 등 유틸리티 └── tests/ # 테스트