Skip to main content
Glama

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á:

  1. Explicar los roles de Host, Server y Tool en MCP.

  2. Ejecutar un servidor MCP STDIO local con Python.

  3. Implementar y modificar una Tool que lea datos no estructurados.

  4. Diseñar una Tool de escritura con límites de validación y aprobación.

  5. Personalizar el MCP con su propio formato de actas de reunión.

  6. Conectar el servidor a Codex o Claude Desktop y demostrar su funcionamiento.

  7. 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 FastMCP funcional: 11 herramientas, 3 recursos, 1 prompt

  • Plantilla 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.py

Para usar MCP Inspector, ejecute lo siguiente:

uv run mcp dev src/meeting_mcp/server.py

Herramientas 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 → [사용자 승인] → SAVED

Etapa

Tool

Lectura/escritura

Función

DISCOVER

list_dummy_notes

lectura

Consulta las 3 notas sintéticas

READ

read_meeting_note

lectura

Consulta el texto original. Admite rango de líneas y ancla de cita L14

GROUND

extract_note_facts

lectura

Extrae candidatos a decisión, fechas y expresiones no confirmadas con número de línea

DRAFT

build_minutes_prompt

lectura

Combina la plantilla y el texto original

CHECK

validate_minutes_draft

lectura

Validación estructural. Proporciona rule_id·severity·line·fix (puerta de guardado)

CHECK

check_minutes_grounding

lectura

Contrasta si personas, fechas y cifras existen en el texto original (asesoramiento, no bloquea el guardado)

PREVIEW

diff_minutes_against_saved

lectura

Comprueba la diferencia con la versión guardada existente

PREVIEW

preview_save_minutes

lectura

Muestra validación, grounding y diff juntos y emite el token de aprobación

SAVED

save_approved_minutes

escritura

Guarda solo si el token de aprobación coincide (única herramienta de escritura)

OBSERVE

list_saved_minutes

lectura

Lista de actas guardadas

OBSERVE

read_minutes_audit_log

lectura

Consulta el registro de auditoría de guardado

Recursos y prompts

Tipo

URI o nombre

Función

Resource

note://{note_id}

Texto original de la nota de reunión

Resource

template://minutes

Plantilla estándar de actas

Resource

minutes://{note_id}

Acta guardada

Prompt

write_minutes

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 stage y next_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 outputSchema se 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 / destructiveHint para 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 list

En 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

  1. START_HERE.md

  2. Práctica 1: Datos y herramientas

  3. Práctica 2: Prompt de actas

  4. Práctica 3: Validación y aprobación

  5. Práctica 4: Conexión de cliente

  6. Práctica 5: Ingeniería de arneses

Comandos de verificación

uv run pytest -q
uv run python scripts/smoke_stdio.py
uv run python scripts/validate_package.py

Principios 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

Available Tools

11 tools
build_minutes_promptA
Read-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_groundingA
Read-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_savedA
Read-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_factsA
Read-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_notesA
Read-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_minutesA
Read-onlyIdempotent

이미 저장된 회의록 목록을 조회합니다.

같은 note_id로 저장하면 덮어쓰기가 되므로, 저장 전에 무엇이 있는지 확인하는 용도입니다.

Returns: SavedListResponse: saved[]에 note_id, 경로, 줄 수, 수정 시각(UTC), 내용 해시 앞 16자.

Inputs: no named parameters. Returns: count, saved, stage, status, +1 more

preview_save_minutesA
Read-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_noteA
Read-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_logA
Read-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_minutesA
DestructiveIdempotent

미리보기에서 발급된 승인 토큰이 일치할 때만 회의록을 파일로 저장합니다.

이 서버에서 유일한 쓰기 도구입니다. 호출 전 반드시 두 조건을 만족해야 합니다.

  1. preview_save_minutes가 AWAITING_APPROVAL을 돌려주고 토큰을 발급했다.

  2. 사용자가 그 내용을 보고 명시적으로 저장을 승인했다.

토큰은 기술적 무결성(승인한 내용 == 저장되는 내용)만 보장합니다. 사용자 승인을 대신하지 않습니다. 사용자가 "저장해"라고 말하지 않았다면 호출하지 마세요.

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_draftA
Read-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

    A4.5/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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