personal-meeting
Click on "Deploy 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., "@personal-meeting Generate a draft minutes from the incident_review note"
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.
My Own MCP Based on a Meeting Minutes Generation Project
An educational local MCP package that reads unstructured meeting notes, builds a meeting-minutes writing prompt, validates the draft, and saves it after user approval.
The company names, person names, schedules, incidents, figures, and statements in this package are all synthetic data created for educational purposes.
Learning Objectives
After completing the lab, trainees will be able to:
Explain the roles of MCP Host, Server, and Tool.
Run a local STDIO MCP server with Python.
Implement and modify a Tool that reads unstructured data.
Design write Tools with validation and approval boundaries.
Customize the MCP to their own meeting-minutes format.
Connect the server to Codex or Claude Desktop and demonstrate it working.
Design tool descriptions, schemas, responses, and errors from a harness engineering perspective.
Related MCP server: LogicNotes MCP Server
What's Included
3 synthetic unstructured meeting notes at different difficulty levels
A working
FastMCPserver: 11 tools, 3 resources, 1 promptA standard meeting-minutes template
Approval-token-based saving and overwrite detection
A grounding checker against the source text
5 trainee lab workbooks
1 instructor answer key
Unit tests for domain, grounding, and harness conventions, plus an STDIO smoke test
Quick Start
Required environment: Python 3.11 or later, uv
uv sync --extra dev
uv run pytest -q
uv run python scripts/smoke_stdio.pyTo use MCP Inspector, run:
uv run mcp dev src/meeting_mcp/server.pyProvided Tools
The recommended flow is in the order below, and the next_actions field in every response tells you the next step.
DISCOVER → READ → GROUND → DRAFT → CHECK → PREVIEW → [사용자 승인] → SAVEDStep | Tool | Read/Write | Role |
DISCOVER |
| Read | View the 3 synthetic notes |
READ |
| Read | View the source text. Supports line ranges and |
GROUND |
| Read | Extract decision candidates, dates, and unconfirmed expressions with line numbers |
DRAFT |
| Read | Combine the template with the source text |
CHECK |
| Read | Structural validation. Provides |
CHECK |
| Read | Cross-check that people, dates, and figures exist in the source (advisory; does not block saving) |
PREVIEW |
| Read | Check the difference against the previously saved version |
PREVIEW |
| Read | Shows validation, grounding, and diff together and issues an approval token |
SAVED |
| Write | Saves only when the approval token matches (the only write tool) |
OBSERVE |
| Read | List saved meeting minutes |
OBSERVE |
| Read | View the save audit log |
Resources and Prompts
Type | URI or Name | Role |
Resource |
| Source meeting note |
Resource |
| Standard meeting-minutes template |
Resource |
| Saved meeting minutes |
Prompt |
| Meeting-minutes writing workflow including the approval boundary |
Harness Design
This server treats not only functionality but also the way the model uses the tools as a design target. See Lab 5 for details.
Every response includes
stageandnext_actions, so the model can pick the next tool from the response alone.Errors return a cause code, a recovery method, and selectable values together.
Argument schemas are kept flat (
{"note_id": "..."}). Using a Pydantic model as the argument type nests them as{"params": {...}}and changes the call shape.Return values are Pydantic models, so
outputSchemais generated automatically.Only definite checks (structure) block saving; heuristic checks (grounding) are only reported as warnings.
Every tool carries
readOnlyHint/destructiveHintto distinguish write tools.
Connecting to Codex
Run the following command from the package root:
codex mcp add personal-meeting -- uv --directory "$PWD" run python src/meeting_mcp/server.py
codex mcp listIn the Codex app, you can also add it as an STDIO server under Settings → MCP servers → Add server. Per OpenAI's official documentation, the Codex app, CLI, and IDE extension share the MCP configuration of the same host.
Connecting to Claude Desktop
Replace ABSOLUTE_PROJECT_PATH in config/claude_desktop_config.example.json with the absolute path to this folder, then apply it to the Claude Desktop settings. You must fully quit the app and relaunch it.
Recommended Lab Prompts
personal-meeting MCP에서 사용 가능한 더미 회의 메모를 보여주세요.training_design 메모를 읽고, 제공된 회의록 템플릿에 맞춰 초안을 작성하세요.
원문에 없는 담당자와 기한은 추정하지 마세요.incident_review 메모에서 extract_note_facts로 ambiguity_flags를 먼저 확인하고,
확정되지 않은 항목은 전부 '미정'으로 남긴 회의록을 작성하세요.작성한 회의록을 validate_minutes_draft와 check_minutes_grounding으로 검증하고,
통과하면 preview_save_minutes까지만 실행하세요. 저장은 아직 하지 마세요.Training Sequence
Verification Commands
uv run pytest -q
uv run python scripts/smoke_stdio.py
uv run python scripts/validate_package.pyDesign Principles
MCP does not call any separate LLM API.
Codex or Claude handles summarization; MCP handles data, validation, and saving.
Information not confirmed in the source text is never generated, and the grounding checker mechanically cross-checks this.
Final saving requires both the approval token issued at preview and the user's explicit approval.
The approval token is a hash of (note_id, body), so the approved content and the saved content cannot diverge.
Domain logic (
core,grounding) is separated from tool conventions (server,harness).In real training, no customer, employee, or contract-related data is used.
References
Base reference repository: https://github.com/kyopark2014/mcp
Codex MCP official docs: https://developers.openai.com/codex/mcp
MCP Python SDK: https://github.com/modelcontextprotocol/python-sdk
Available Tools
11 toolsbuild_minutes_promptARead-onlyIdempotent
회의 메모와 표준 템플릿을 결합한 회의록 작성 프롬프트를 반환합니다.
이 MCP는 LLM API를 호출하지 않습니다. 요약은 호스트(Claude/Codex)가 하고, 이 도구는 '무엇을 어떤 형식으로 쓸지'에 대한 지시문만 조립합니다.
Args: note_id: 메모 id. with_line_numbers: 원문 줄 번호 부착 및 인용 규칙 추가 여부 (기본 True).
Returns:
PromptResponse: prompt에 규칙 + 템플릿 + 원문이 담긴 지시문.
Inputs: note_id (required), with_line_numbers. Returns: stage, prompt, status, note_id, +1 more
check_minutes_groundingARead-onlyIdempotent
회의록에 적힌 사람·날짜·수치가 원문에서 확인되는지 역으로 대조합니다.
"원문에 없는 결정·담당자·기한을 추정하지 않는다"는 규칙을 사람 눈 대신 기계가 확인합니다. 날짜는 '9월 15일', '8/27', '20일' 같은 원문 표현을 ISO로 정규화한 뒤 비교하므로, 정상적인 회의록이 오탐으로 잡히지 않습니다.
검사 항목: - person_unsupported: 담당자·결정자 이름이 원문에 없음 - date_unsupported / year_unsupported: 날짜·연도의 근거가 원문에 없음 - number_unsupported: 원문에 없는 수치가 새로 생김 - evidence_missing: 실행 항목·리스크의 근거 칸이 비어 있음(참고) - ambiguity_dropped: 원문의 애매한 부분이 회의록에서 전부 확정되어 버림
중요: 이 검사는 자문(advisory) 입니다. 휴리스틱이므로 오탐이 있을 수 있고, 저장을 막지 않습니다. 저장 게이트는 validate_minutes_draft(구조)와 사용자 승인입니다. 경고가 났다면 해당 줄의 원문을 read_meeting_note로 다시 확인하고, 근거가 없으면 '미정'으로 바꾸세요.
Args: note_id: 원본 메모 id. minutes_markdown: 회의록 초안 전문. max_findings: 최대 지적 건수 (기본 30).
Returns:
GroundingResponse: status(GROUNDED / MOSTLY_GROUNDED /
NEEDS_EVIDENCE_REVIEW), score(0-100), findings[].
Inputs: note_id (required), minutes_markdown (required), max_findings. Returns: score, stage, status, checked, +5 more
diff_minutes_against_savedARead-onlyIdempotent
이미 저장된 회의록과 초안의 차이를 보여 줍니다.
같은 note_id로 두 번째 저장을 하면 기존 파일을 덮어씁니다. 무엇이 사라지는지 먼저 확인해 사고를 막는 용도입니다.
Args: note_id: 메모 id. minutes_markdown: 초안 전문. diff_preview_lines: unified diff 미리보기 줄 수 (기본 40).
Returns:
DiffResponse: diff.write_mode가 CREATE / OVERWRITE / NO_CHANGE 중 하나.
Inputs: note_id (required), minutes_markdown (required), diff_preview_lines. Returns: diff, stage, status, target, +2 more
extract_note_factsARead-onlyIdempotent
초안을 쓰기 전에 원문에서 '인용 가능한 사실'을 줄 번호와 함께 뽑습니다.
할루시네이션을 막는 가장 효과적인 방법은 사후 검사가 아니라 사전 앵커링
입니다. 이 도구는 참석자, 발화 줄, 날짜 표현, 결정 후보, 실행 항목 후보,
그리고 특히 ambiguity_flags(확정되지 않은 표현이 있는 줄)를 돌려줍니다.
ambiguity_flags에 걸린 내용은 회의록에서 '미정'으로 남겨야 합니다.
Args: note_id: 메모 id. max_items_per_category: 분류별 최대 항목 수 (기본 15).
Returns:
NoteFactsResponse: 각 항목이 line(원문 줄 번호)과 text를 가집니다.
truncated_categories에 잘린 분류 이름이 들어갑니다.
Examples: - 사용: 초안 작성 직전, 근거 칸에 적을 앵커를 확보할 때 - 사용: 근거 검사에서 '담당자를 원문에서 찾지 못했습니다' 경고가 났을 때 - 사용하지 않음: 이미 완성된 초안을 검증할 때 → check_minutes_grounding
Inputs: note_id (required), max_items_per_category. Returns: stage, status, note_id, date_lines, +9 more
list_dummy_notesARead-onlyIdempotent
교육 패키지에 포함된 합성 비정형 회의 메모 목록을 조회합니다.
회의록 작업의 출발점입니다. 여기서 얻은 note_id를 다른 모든 도구에 넘깁니다.
Returns:
NoteListResponse: notes[]에 note_id, 제목, 난이도(초급/중급/고급),
줄 수, 글자 수, 그리고 has_minutes(이미 회의록을 저장한 메모인지)와
minutes_saved_utc(저장본의 마지막 수정 시각, 없으면 null)가 담깁니다.
has_minutes가 True인 메모는 저장 시 덮어쓰기가 되므로,
next_actions에 diff_minutes_against_saved가 함께 제시됩니다.
Examples: - 사용: "어떤 더미 메모가 있나요?" - 사용: "이미 회의록을 만든 메모가 있나요?" - 사용하지 않음: 이미 note_id를 알고 있고 원문이 필요할 때 → read_meeting_note
Inputs: no named parameters. Returns: count, notes, stage, status, +1 more
list_saved_minutesARead-onlyIdempotent
이미 저장된 회의록 목록을 조회합니다.
같은 note_id로 저장하면 덮어쓰기가 되므로, 저장 전에 무엇이 있는지 확인하는 용도입니다.
Returns:
SavedListResponse: saved[]에 note_id, 경로, 줄 수, 수정 시각(UTC),
내용 해시 앞 16자.
Inputs: no named parameters. Returns: count, saved, stage, status, +1 more
preview_save_minutesARead-onlyIdempotent
저장 대상·변경 내용·검증·근거 결과를 한 번에 보여 주고 승인 토큰을 발급합니다.
저장 직전의 단일 관문입니다. 구조 검증을 통과했을 때만 approval_token이
발급되며, 토큰은 (note_id, 본문) 해시라서 승인받은 내용과 저장되는 내용이
달라질 수 없습니다.
토큰은 사용자 승인을 대신하지 않습니다. 응답의 approval_request를
사용자에게 그대로 보여 주고, 사용자가 명시적으로 승인한 뒤에만
save_approved_minutes를 호출하세요.
Args: note_id: 메모 id. minutes_markdown: 저장할 회의록 전문. include_preview: 전문을 응답에 다시 담을지 여부 (기본 False). max_preview_chars: preview 최대 길이 (기본 4000).
Returns:
PreviewResponse: status(AWAITING_APPROVAL / NEEDS_REVISION),
approval_token, validation, grounding, diff,
approval_request.
Inputs: note_id (required), minutes_markdown (required), include_preview, max_preview_chars. Returns: diff, stage, status, target, +8 more
read_meeting_noteARead-onlyIdempotent
note_id에 해당하는 합성 회의 메모 원문을 읽습니다.
긴 메모를 통째로 읽어 컨텍스트를 낭비하지 않도록 줄 범위를 지정할 수 있고, 근거 검사에서 경고가 난 줄만 다시 확인할 때도 이 범위 인자를 씁니다.
Args: note_id: 메모 id. start_line: 시작 줄(1부터). 기본 1. end_line: 끝 줄. 생략하면 끝까지. with_line_numbers: 줄 번호 접두사 부착 여부. 기본 True.
Returns:
NoteContentResponse: content에 본문, total_lines에 전체 줄 수,
truncated에 일부만 읽었는지 여부.
Raises: ToolFailure: NOTE_NOT_FOUND / INVALID_NOTE_ID. 오류 메시지에 사용 가능한 note_id 목록이 함께 담깁니다.
Inputs: note_id (required), end_line, start_line, with_line_numbers. Returns: stage, status, content, note_id, +5 more
read_minutes_audit_logARead-onlyIdempotent
회의록 저장 감사 로그를 최신순으로 조회합니다.
AWAITING_APPROVAL → SAVED 흐름의 실행 증거를 제출할 때 사용합니다.
각 이벤트에는 시각, note_id, write_mode, 변경 줄 수, 내용 해시가 담깁니다.
Args: limit: 최대 건수 (기본 20). note_id: 특정 메모로 필터링 (선택).
Returns:
AuditResponse: events[] 최신순.
Inputs: limit, note_id. Returns: count, stage, events, status, +1 more
save_approved_minutesADestructiveIdempotent
미리보기에서 발급된 승인 토큰이 일치할 때만 회의록을 파일로 저장합니다.
이 서버에서 유일한 쓰기 도구입니다. 호출 전 반드시 두 조건을 만족해야 합니다.
preview_save_minutes가
AWAITING_APPROVAL을 돌려주고 토큰을 발급했다.사용자가 그 내용을 보고 명시적으로 저장을 승인했다.
토큰은 기술적 무결성(승인한 내용 == 저장되는 내용)만 보장합니다. 사용자 승인을 대신하지 않습니다. 사용자가 "저장해"라고 말하지 않았다면 호출하지 마세요.
Args: note_id: 메모 id. minutes_markdown: 저장할 회의록 전문. approval_token: 미리보기가 발급한 토큰. expected_write_mode: 선택. 지정하면 실제 write_mode와 다를 때 거부합니다.
Returns:
SaveResponse: path(저장 경로), audit(감사 로그 경로),
write_mode(CREATE / OVERWRITE / NO_CHANGE).
Raises: ToolFailure: TOKEN_MISMATCH, VALIDATION_FAILED, WRITE_MODE_CHANGED, INVALID_NOTE_ID. 모두 복구 방법이 메시지에 포함됩니다.
Inputs: note_id (required), approval_token (required), minutes_markdown (required), expected_write_mode. Returns: path, audit, stage, status, +3 more
validate_minutes_draftARead-onlyIdempotent
회의록 초안의 구조를 검사합니다. 저장 게이트입니다.
error가 하나라도 있으면 preview_save_minutes에서 승인 토큰이 발급되지
않습니다. 각 항목은 rule_id, severity, line, fix를 가지므로
다시 물어보지 않고 스스로 고칠 수 있습니다.
검사 항목: - error: H1 제목, 필수 섹션 8개('## 고객 영향' 포함), 실행 항목 표 헤더, 실행 항목 행의 칸 수 - warning: 섹션 순서, 기한 형식(YYYY-MM-DD 또는 '미정'), 자리표시자 잔존, '미정' 표기 누락, 리스크 표 헤더, 머리말의 '- 원문:' 항목, 민감정보 패턴(이메일·전화번호·주민등록번호 형식·자격증명 값)
Args: minutes_markdown: 회의록 초안 전문.
Returns:
ValidationResponse: valid, error_count, warning_count,
issues[](rule_id/severity/message/fix/line).
Examples: - 사용: 초안을 쓴 직후, 저장 미리보기 전 - 사용하지 않음: 내용이 원문에 근거하는지 볼 때 → check_minutes_grounding
Inputs: minutes_markdown (required). Returns: stage, valid, issues, status, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a distinct role in the minutes-generation workflow: listing notes, saving minutes, reading content, extracting facts, building prompts, validating structure, checking grounding, diffing, previewing, and saving. No two tools overlap in purpose, and descriptions clearly differentiate list_dummy_notes from list_saved_minutes and validation from grounding checks.
All tool names follow a consistent verb_noun snake_case pattern (list_, read_, extract_, build_, validate_, check_, diff_, preview_, save_). This uniform convention makes the tool set predictable and easy to navigate for an agent.
With 11 tools, the server covers the full lifecycle of meeting minutes creation without being bloated. Each tool serves a clear purpose in the pipeline, and the count is well-scoped for the domain.
The workflow is nearly complete: listing, reading, extracting facts, building prompts, validating, grounding, diffing, previewing, and saving. The only notable gap is the absence of a tool to read the full content of a saved minute (only metadata via list_saved_minutes and diff via diff_minutes_against_saved), which agents could work around.
Maintenance
Related MCP Connectors
Search, read, analyze and create HappyScribe transcripts and meeting notes from any MCP client
MCP server for generating rough-draft project plans from natural-language prompts.
Memoket — access your recording transcripts, summaries, and key takeaways over MCP.
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server for reading, editing, and validating Microsoft Word documents with specialized support for track changes, comments, and footnotes. It enables structural auditing, heading extraction, and precise OOXML-level document manipulation through natural language tools.101001,196 PyPI69MIT
- AlicenseNot gradedqualityDmaintenanceRead-only MCP server for searching and retrieving LogicNotes meeting notes, including summaries, transcripts, and action items.MIT
- FlicenseNot gradedqualityCmaintenanceMCP server for transcribing audio and generating structured customer requirement meeting minutes (including flowcharts) using Whisper and AI backends, with export to md/html/pdf/docx and model/settings management.1-
- AlicenseAqualityDmaintenanceEnables creating meeting minutes from unstructured meeting memos with validation, grounding checks, and user-approved saving.11MIT