Work Note MCP Server

Work Note MCP Server

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.

Category
Visit Server

README

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured