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 list available dummy meeting notes"
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 meeting minutes writing prompts, validates drafts, and saves them 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 a write Tool with validation and approval boundaries.
Customize the MCP to their own meeting minutes format.
Connect the server to Codex or Claude Desktop and demonstrate its behavior.
Design tool descriptions, schemas, responses, and errors from a harness engineering perspective.
Related MCP server: personal-meeting
What's Included
3 synthetic unstructured meeting notes by difficulty level
A working
FastMCPserver: 11 tools, 3 resources, 1 promptA standard meeting minutes template
Approval-token-based saving and overwrite detection
A grounding checker that cross-references the source text
5 trainee lab workbooks
1 instructor answer example
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 the following:
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 3 synthetic notes |
READ |
| Read | View the source text. Supports line range specification 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 text (advisory, does not block saving) |
PREVIEW |
| Read | Check the difference from the existing 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 of saved meeting minutes |
OBSERVE |
| Read | View the save audit log |
Resources and Prompts
Type | URI or Name | Role |
Resource |
| Meeting note source text |
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 tools as a design target. See Lab 5 for details.
Every response includes
stageandnext_actions, so the model can choose the next tool from the response alone.Errors return a cause code, recovery method, and selectable values together.
Argument schemas are kept flat (
{"note_id": "..."}). Using a Pydantic model as an argument type nests them as{"params": {...}}and changes the call shape.Return values are Pydantic models, so
outputSchemais generated automatically.Only definitive checks (structure) block saving; heuristic checks (grounding) are reported as warnings only.
Every tool has
readOnlyHint/destructiveHintto distinguish write tools.
Codex Connection
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 MCP settings on the same host.
Claude Desktop Connection
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 a separate LLM API.
Codex or Claude handles summarization, and MCP handles data, validation, and storage.
Information not confirmed in the source text is not generated, and the grounding checker mechanically cross-references it.
Final saving requires both the approval token issued in the preview and explicit user 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).Real training does not use customer, employee, or contract-related data.
References
Base reference repository: https://github.com/kyopark2014/mcp
Codex MCP official documentation: 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, 제목, 난이도(초급/중급/고급),
줄 수, 글자 수가 담깁니다.
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 제목, 필수 섹션 7개, 실행 항목 표 헤더, 실행 항목 행의 칸 수 - 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 targets a distinct step in the meeting-minutes workflow: listing/reading notes, extracting facts, building prompts, validating structure, checking grounding, previewing, saving, listing saved minutes, and auditing. Even similar-sounding tools (diff, preview, check) serve clearly different purposes—diff compares against saved, preview gates with a token, and check verifies source grounding.
All tools follow a consistent verb_noun snake_case pattern (list_dummy_notes, read_meeting_note, validate_minutes_draft, save_approved_minutes). Verbs clearly indicate action and objects are always the minute/note entity, making tool selection predictable.
With 11 tools, the surface is well-scoped for a single domain: creating, validating, and saving meeting minutes. Each tool contributes a distinct function from note discovery through audit logging, with no redundancy or bloat.
The set covers the full lifecycle: list/read source notes, extract anchors, build prompt, validate draft, check grounding, preview with approval token, save (including overwrite protection via diff), list saved minutes, and audit. The only write path is gated and logged, so there are no dead ends.
Maintenance
Related MCP Connectors
Start meetings and work with meeting transcripts, notes, recordings and follow-up tasks.
Transcripts, recaps, and action items. Authenticated; OAuth 2.1 via Keycloak.
Bring meeting decisions, tasks and user stories into your AI editor (Claude, Cursor, Copilot).
Turn meeting notes or transcripts into a clean structured summary document from chat.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables automatic generation of structured meeting minutes from Feishu meeting links, date ranges, or arbitrary meeting transcripts, with summaries and action items organized by department.-
- AlicenseAqualityDmaintenanceEnables reading unstructured meeting notes, generating meeting minutes drafts, validating them against source text, and saving approved versions through a local MCP server.11MIT
- AlicenseNot gradedqualityBmaintenanceEnables ingesting a board meeting transcript, querying what was decided, confirming a mover or seconder, and drafting and approving minutes with audit trails and decision cards. Keeps that layered state per board across sessions, enforcing guardrails such as blocking approval while an attribution is unconfirmed.MIT
- AlicenseNot gradedqualityBmaintenanceEnables an Alexa+ style assistant to run a board meeting minutes loop: ingest a transcript, list meetings, motions and decisions, confirm a mover or seconder from a roster, prepare topic packets with approved totals, and approve or hold minutes with an audit trail. Keeps that state per board across sessions and refuses approval while any attribution is unconfirmed.MIT