基于会议纪要生成项目的个人 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: Guarded MCP Agent

包含内容

• 按难度划分的 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

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

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