議事録生成プロジェクトベースの自作MCP

非構造化の会議メモを参照し、議事録作成プロンプトを作成し、ドラフトを検証したうえでユーザー承認後に保存する教育用ローカルMCPパッケージです。

このパッケージの会社名、人名、スケジュール、障害、数値、発言はすべて教育用に作成した合成データです。

教育目標

受講者は実習を終えると、次のことができるようになります。

1. MCPのHost、Server、Toolの役割を説明できる。

2. PythonでローカルSTDIO MCPサーバーを実行できる。

3. 非構造化データを読み取るToolを実装・修正できる。

4. 検証と承認の境界がある書き込みToolを設計できる。

5. 自分の議事録形式にMCPをカスタマイズできる。

6. CodexまたはClaude Desktopにサーバーを接続し、動作を実証できる。

7. ハーネスエンジニアリングの観点からツール説明・スキーマ・応答・エラーを設計できる。

Related MCP server: Guarded MCP Agent

含まれる内容

• 難易度別の合成非構造化会議メモ3件

• 動作するFastMCPサーバー: ツール11個、リソース3個、プロンプト1個

• 標準議事録テンプレート

• 承認トークンによる保存と上書き検知

• 原文根拠照合(grounding)チェッカー

• 受講者用実習書5冊

• 講師用の解答例1件

• ドメイン・根拠・ハーネス規約のユニットテストと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

リソースとプロンプト

ハーネス設計

このサーバーは機能だけでなく、モデルがツールを使う方法を設計対象としています。 詳細は実習5にあります。

• すべての応答にstageとnext_actionsがあり、モデルが応答だけを見て次のツールを選びます。

• エラーは原因コード・復旧方法・選択可能な値を一緒に返します。

• 引数スキーマはフラットに保ちます({"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: ハーネスエンジニアリング

検証コマンド

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