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/

참고

라이센스

MIT

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables automatic creation and management of weekly work reports in Korean through structured templates. Organizes work tasks and issues with automatic file management, backup/rollback, and 100% template compliance through JSON Schema validation.

Related MCP Servers

DeltaTask MCP Server
brysontang
A
security
A
license
A
quality
Provides API access to a locally-hosted task management system with features for creating, updating, and organizing tasks, including support for urgency levels, effort estimates, subtasks, and bi-directional sync with Obsidian markdown files.
Last updated -
12
8
MIT License
Weekly Report MCP Server
tobecrazy
-
security
F
license
-
quality
A simple MCP server that allows users to write and save weekly reports to text files in a dedicated reports directory.
Last updated -
Jira Weekly Reporter MCP Server
Jongryong
-
security
F
license
-
quality
Connects to Jira instances to generate weekly reports based on issue activity, supporting custom JQL queries and optional LLM summarization.
Last updated -
Routineofficial
routineco
A
security
F
license
A
quality
Interact with Routine (https://routine.co/): manage calendars, tasks, notes, etc.
Last updated -
18
10
2

View all related MCP servers

Work Note MCP Server