会議議事録生成プロジェクト基盤の自分専用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: Local Knowledge Desk

含まれる内容

• 難易度別の合成非構造化会議メモ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