生成会议纪要项目基础的自有 MCP

用于教育目的的本地 MCP 包：可查询非结构化的会议笔记、生成会议纪要编写提示词、验证草稿，并在用户批准后保存。

本包中的公司名、人名、日程、故障、数字、发言均为教育目的合成的数据。

教育目标

学员完成实操后将能够做到以下内容：

1. 说明 MCP 的 Host、Server、Tool 角色。

2. 使用 Python 运行本地 STDIO MCP 服务器。

3. 实现并修改读取非结构化数据的 Tool。

4. 设计带有验证与批准边界的写入 Tool。

5. 按自己的会议纪要格式定制 MCP。

6. 在 Codex 或 Claude Desktop 中连接服务器并证明其运行。

7. 从 harness 工程角度设计工具说明、schema、响应和错误。

Related MCP server: Local Knowledge Desk

包含内容

• 按难度区分的合成非结构化会议笔记 3 个

• 可运行的 FastMCP 服务器：工具 11 个、资源 3 个、提示词 1 个

• 标准会议纪要模板

• 基于批准令牌的保存与覆盖检测

• 原文依据对照（grounding）检查器

• 学员实操手册 5 份

• 讲师用参考答案示例 1 份

• 领域、依据、harness 约定的单元测试与 STDIO 冒烟测试

快速开始

必需环境：Python 3.11 及以上、uv

uv sync --extra dev
uv run pytest -q
uv run python scripts/smoke_stdio.py

如需使用 MCP Inspector，请运行以下命令：

uv run mcp dev src/meeting_mcp/server.py

提供的工具

推荐流程按以下顺序进行，所有响应的 next_actions 字段会指示下一步操作。

DISCOVER → READ → GROUND → DRAFT → CHECK → PREVIEW → [사용자 승인] → SAVED

资源与提示词

Harness 设计

此服务器不仅关注功能，还将模型使用工具的方式作为设计对象。 详见实操 5。

• 所有响应均包含 stage 和 next_actions，使模型仅根据响应即可选择下一个工具。

• 错误会同时返回原因代码、恢复方法及可选值。

• 参数 schema 保持扁平（{"note_id": "..."}）。若将 Pydantic 模型用作参数类型，会嵌套为 {"params": {...}}，改变调用形式。

• 返回值采用 Pydantic 模型，因此会自动生成 outputSchema。

• 仅明确的检查（结构）阻止保存，启发式检查（依据）仅作为警告提示。

• 所有工具均标注 readOnlyHint / destructiveHint，以区分写入工具。

Codex 连接

在包根目录运行以下命令：

codex mcp add personal-meeting -- uv --directory "$PWD" run python src/meeting_mcp/server.py
codex mcp list

在 Codex 应用中，也可以通过 Settings → MCP servers → Add server 将其添加为 STDIO 服务器。根据 OpenAI 官方文档，Codex 应用、CLI、IDE 扩展共享同一主机的 MCP 配置。

Claude Desktop 连接

将 config/claude_desktop_config.example.json 中的 ABSOLUTE_PROJECT_PATH 替换为本文件夹的绝对路径，然后应用到 Claude Desktop 设置。完成后需完全退出并重新启动应用。

推荐实操提示词

personal-meeting MCP에서 사용 가능한 더미 회의 메모를 보여주세요.

training_design 메모를 읽고, 제공된 회의록 템플릿에 맞춰 초안을 작성하세요.
원문에 없는 담당자와 기한은 추정하지 마세요.

incident_review 메모에서 extract_note_facts로 ambiguity_flags를 먼저 확인하고,
확정되지 않은 항목은 전부 '미정'으로 남긴 회의록을 작성하세요.

작성한 회의록을 validate_minutes_draft와 check_minutes_grounding으로 검증하고,
통과하면 preview_save_minutes까지만 실행하세요. 저장은 아직 하지 마세요.

教学进阶顺序

1. START_HERE.md

2. 实操 1：数据与 Tool

3. 实操 2：会议纪要提示词

4. 实操 3：验证与批准

5. 实操 4：客户端连接

6. 实操 5：Harness 工程

验证命令

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

设计原则

• MCP 不调用单独的 LLM API。

• Codex 或 Claude 负责摘要，MCP 负责数据、验证与保存。

• 不生成原文中未确认的信息，依据检查器会机械地对照验证。

• 最终保存必须同时具备预览中签发的批准令牌和用户的明确批准。

• 批准令牌是（note_id, 正文）的哈希，因此已批准的内容与保存的内容不能不一致。

• 将领域逻辑（core、grounding）与工具约定（server、harness）分离。

• 实际教学中不使用客户、员工、合同相关数据。

参考

• 基础参考仓库：https://github.com/kyopark2014/mcp

• Codex MCP 官方文档：https://developers.openai.com/codex/mcp

• MCP Python SDK：https://github.com/modelcontextprotocol/python-sdk