Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Work Note MCP Server오늘 진행한 API 성능 개선 작업을 업무노트에 추가해줘"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Work Note MCP Server
Claude와 연동해서 주간업무 보고서를 자동으로 작성하는 MCP 서버.
왜 만들었나
매주 작성하는 주간업무 보고서를 Claude로 자동화하려고 서브 에이전트를 만들었는데, 템플릿 준수율이 85-90% 정도밖에 안 됐다. Claude가 계속 템플릿을 "개선"하려고 해서 MCP 프로토콜로 전환했더니 100% 준수율을 달성했다.
Related MCP server: Weekly Report Checker
핵심 기능
업무노트 작성: 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.pyClaude Desktop 연동
설정 파일 위치:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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/참고
라이센스
MIT