Work Note MCP Server

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

왜 만들었나

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

핵심 기능

• 업무노트 작성: 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/               # 테스트

디버깅

# 로그 레벨 설정해서 실행
export MCP_LOG_LEVEL=DEBUG
python main.py

# 테스트
pytest tests/

참고

• MCP Documentation
• Python MCP SDK

라이센스

MIT