personal-meeting
Mi propio MCP basado en un proyecto de generación de actas de reunión
Paquete MCP local educativo que consulta notas de reunión no estructuradas, crea un prompt para redactar actas, valida el borrador y lo guarda tras la aprobación del usuario.
Los nombres de empresas, personas, fechas, incidencias, cifras y declaraciones de este paquete son datos sintéticos creados con fines educativos.
Objetivos educativos
Al finalizar la práctica, el alumno podrá:
Explicar los roles de Host, Server y Tool en MCP.
Ejecutar un servidor MCP STDIO local con Python.
Implementar y modificar una Tool que lea datos no estructurados.
Diseñar una Tool de escritura con límites de validación y aprobación.
Personalizar el MCP con su propio formato de actas de reunión.
Conectar el servidor a Codex o Claude Desktop y demostrar su funcionamiento.
Diseñar descripciones de herramientas, esquemas, respuestas y errores desde la perspectiva de la ingeniería de arneses (harness engineering).
Related MCP server: personal-meeting
Contenido incluido
3 notas de reunión sintéticas no estructuradas por nivel de dificultad
Servidor
FastMCPfuncional: 11 herramientas, 3 recursos, 1 promptPlantilla estándar de actas de reunión
Guardado basado en token de aprobación y detección de sobrescritura
Verificador de contraste con el texto original (grounding)
5 guías de práctica para el alumno
1 ejemplo de solución para el instructor
Pruebas unitarias de dominio, grounding y convenciones de arnés, además de pruebas de humo STDIO
Inicio rápido
Entorno requerido: Python 3.11 o superior, uv
uv sync --extra dev
uv run pytest -q
uv run python scripts/smoke_stdio.pyPara usar MCP Inspector, ejecute lo siguiente:
uv run mcp dev src/meeting_mcp/server.pyHerramientas proporcionadas
El flujo recomendado sigue el orden siguiente, y el campo next_actions de cada respuesta indica el siguiente paso.
DISCOVER → READ → GROUND → DRAFT → CHECK → PREVIEW → [사용자 승인] → SAVEDEtapa | Tool | Lectura/escritura | Función |
DISCOVER |
| lectura | Consulta las 3 notas sintéticas |
READ |
| lectura | Consulta el texto original. Admite rango de líneas y ancla de cita |
GROUND |
| lectura | Extrae candidatos a decisión, fechas y expresiones no confirmadas con número de línea |
DRAFT |
| lectura | Combina la plantilla y el texto original |
CHECK |
| lectura | Validación estructural. Proporciona |
CHECK |
| lectura | Contrasta si personas, fechas y cifras existen en el texto original (asesoramiento, no bloquea el guardado) |
PREVIEW |
| lectura | Comprueba la diferencia con la versión guardada existente |
PREVIEW |
| lectura | Muestra validación, grounding y diff juntos y emite el token de aprobación |
SAVED |
| escritura | Guarda solo si el token de aprobación coincide (única herramienta de escritura) |
OBSERVE |
| lectura | Lista de actas guardadas |
OBSERVE |
| lectura | Consulta el registro de auditoría de guardado |
Recursos y prompts
Tipo | URI o nombre | Función |
Resource |
| Texto original de la nota de reunión |
Resource |
| Plantilla estándar de actas |
Resource |
| Acta guardada |
Prompt |
| Flujo de redacción de actas que incluye el límite de aprobación |
Diseño del arnés
Este servidor considera como objeto de diseño no solo la funcionalidad, sino también la forma en que el modelo utiliza las herramientas. Los detalles se encuentran en la Práctica 5.
Todas las respuestas incluyen
stageynext_actions, de modo que el modelo elige la siguiente herramienta con solo ver la respuesta.Los errores devuelven el código de causa, el método de recuperación y los valores seleccionables.
El esquema de argumentos se mantiene plano (
{"note_id": "..."}). Si se usa un modelo Pydantic como tipo de argumento, se anida como{"params": {...}}y cambia la forma de la llamada.El valor de retorno es un modelo Pydantic, por lo que
outputSchemase genera automáticamente.Solo las comprobaciones definitivas (estructurales) bloquean el guardado; las comprobaciones heurísticas (grounding) solo se notifican como advertencia.
Todas las herramientas llevan
readOnlyHint/destructiveHintpara distinguir las herramientas de escritura.
Conexión con Codex
Ejecute el siguiente comando en la raíz del paquete.
codex mcp add personal-meeting -- uv --directory "$PWD" run python src/meeting_mcp/server.py
codex mcp listEn la aplicación Codex también se puede añadir como servidor STDIO en Settings → MCP servers → Add server. Según la documentación oficial de OpenAI, la aplicación Codex, la CLI y la extensión del IDE comparten la configuración MCP del mismo host.
Conexión con Claude Desktop
Reemplace ABSOLUTE_PROJECT_PATH en config/claude_desktop_config.example.json por la ruta absoluta de esta carpeta y aplíquelo en la configuración de Claude Desktop. Debe cerrar la aplicación por completo y volver a abrirla.
Prompts recomendados para la práctica
personal-meeting MCP에서 사용 가능한 더미 회의 메모를 보여주세요.training_design 메모를 읽고, 제공된 회의록 템플릿에 맞춰 초안을 작성하세요.
원문에 없는 담당자와 기한은 추정하지 마세요.incident_review 메모에서 extract_note_facts로 ambiguity_flags를 먼저 확인하고,
확정되지 않은 항목은 전부 '미정'으로 남긴 회의록을 작성하세요.작성한 회의록을 validate_minutes_draft와 check_minutes_grounding으로 검증하고,
통과하면 preview_save_minutes까지만 실행하세요. 저장은 아직 하지 마세요.Orden de la formación
Comandos de verificación
uv run pytest -q
uv run python scripts/smoke_stdio.py
uv run python scripts/validate_package.pyPrincipios de diseño
MCP no realiza llamadas a APIs de LLM independientes.
Codex o Claude se encargan de resumir; MCP se encarga de los datos, la validación y el guardado.
No se genera información no confirmada en el texto original; el verificador de grounding la contrasta mecánicamente.
El guardado final requiere tanto el token de aprobación emitido en la vista previa como la aprobación explícita del usuario.
El token de aprobación es un hash de (note_id, contenido), por lo que el contenido aprobado y el guardado no pueden diferir.
Se separa la lógica de dominio (
core,grounding) de las convenciones de herramientas (server,harness).En la formación real no se utilizan datos de clientes, empleados ni contratos.
Referencias
Repositorio de referencia base: https://github.com/kyopark2014/mcp
Documentación oficial de Codex MCP: https://developers.openai.com/codex/mcp
SDK de Python de MCP: 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.
Meeting transcripts & AI minutes for your agent: search, read, send meeting bots, import.
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).
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