mcp-persona-sessions

mcp-persona-sessions

AI アシスタントが、面接の準備、個人的な振り返り、コーチングの会話など、ペルソナに基づいた構造化セッションを実施できるようにする Model Context Protocol（MCP）サーバーです。

概要

リアルなペルソナに基づいたセッションで、AI とのやり取りを変革しましょう。もともとは模擬面接の準備（大切な会議の前に「新しい上司」と練習すること）を目的として設計されましたが、あらゆる種類のガイド付き会話に対応する柔軟なフレームワークへと進化しました。

重要なプレゼンテーションの準備、構造化された自己内省、安全な環境での難しい会話の練習など、このサーバーは有意義なガイド付き対話のためのフレームワークを提供します。

主な機能

• 🎭 ペルソナに基づいたセッション：詳細なペルソナプロファイルを読み込み、AI の振る舞いや専門知識を全面的に変化させます
• ⏱️ タイマー管理機能を標準搭載：開始、停止、状態確認によってセッション時間を記録します
• 📋 構造化されたフレームワーク：明確な目標と成果を定めた、あらかじめ用意されたセッションテンプレート
• 🔄 適応型の進行：会話の中で自然に生まれる内容に応じてセッションが変化します
• 📊 セッション評価：パフォーマンスやコミュニケーションの有効性について詳細なフィードバックを得られます
• 🔒 安全な運用：パス検証とエラー処理による安全なファイル操作

セッションの種類

会議の準備

リアルなペルソナとの会話を練習します。

• 医療機関の CIO：使命を重視するリーダーシップの視点を交えた技術的な議論
• 役員：全体的な戦略に関する会話
• チームリーダー：協働的な計画立案や意思決定のセッション

個人的な振り返り

次の内容を行き来しながら進む、適応型のジャーナリングセッションです。

• 日々の経験の整理
• 創造的な探求とひらめき
• 感謝の実践と大切なことへの気づき
• 人生のパターンの認識と成長計画

カスタムセッション

特定のニーズに合わせて、独自のペルソナやセッションフレームワークを作成します。

クイックスタート

前提条件

• Python 3.8+
• MCP 対応の AI アシスタント（Claude Desktop など）

インストール

1. リポジトリをクローンします。

git clone https://github.com/mattjoyce/mcp-persona-sessions.git
cd mcp-persona-sessions

2. 依存関係をインストールします。

pip install fastmcp

3. 設定を行います。

cp config.yaml.example config.yaml
# Edit config.yaml with your preferences

MCP クライアントの設定

MCP クライアントの設定（Claude Desktop など）に追加します。

{
  "mcpServers": {
    "persona-sessions": {
      "command": "/path/to/venv/python",
      "args": ["/path/to/mcp-persona-sessions/mcp-persona-sessions.py"],
      "cwd": "/path/to/mcp-persona-sessions"
    }
  }
}

使用方法

基本的なセッションの流れ

私は MCP クライアントとして Claude を使っていますが、別のものを使ってもかまいません。 Claude にセッションを開始するよう簡単に頼んでください。

「Claude、ツールを使って模擬会議を実施してください。この会議は XXX と行うもので、テーマは YYY、時間は 10 分です。」 参考になるドキュメントがあれば、リクエストに添付してください。

設定

config.yaml

persona_path: "roles"                           # Directory containing persona files
session_types_file: "session_types.yaml"       # Session framework definitions
default_persona_file: "Role-Interviewer-mcp.md" # Fallback persona
evaluator_persona_file: "Role-Interview-Evaluator.md" # Feedback persona

カスタムペルソナの追加

roles/ ディレクトリに新しい .md ファイルを作成し、次の内容を記述します。

# Your Persona Name

## Identity and Purpose
[Define who this persona is and their role]

## Communication Style
[How they speak and interact]

## Expertise Areas
[What they know and focus on]

## Goals
[What they aim to achieve in sessions]

[Additional sections as needed...]

カスタムセッションタイプの追加

新しいセッションフレームワークを追加するには、session_types.yaml を編集します。

session_types:
  - name: "Your Custom Session"
    persona: "Your Persona"
    persona_file: "Role-Your-Persona.md"
    description: "What this session accomplishes"
    prerequisites: ["What's needed to start"]
    duration: 20
    topics: ["Key areas to explore"]
    goals: ["Session outcomes"]

プロジェクト構成

mcp-persona-sessions/
├── mcp-persona-sessions.py    # Main MCP server
├── timer.py                   # Timer management utilities
├── config.yaml               # Server configuration
├── session_types.yaml        # Available session frameworks
├── roles/                     # Persona definition files
│   ├── Role-CIO.md
│   ├── Role-Reflective-Companion.md
│   ├── Role-Interview-Evaluator.md
│   └── ...
├── requirements.txt
└── README.md

利用可能なツール

ツール	用途
list_session_frameworks	利用可能なセッションタイプとテンプレートを確認します
list_session_personas	利用可能なすべてのペルソナを表示します
get_persona_details	特定のペルソナの詳細を取得します
assess_session_readiness	セッションを開始する準備ができているか確認します
initialize_session	構造化セッションを開始します
start_timer	時間を指定してセッションタイマーを開始します（時間の指定は任意です）
check_timer_status	実行中のタイマーの進行状況を確認します
stop_timer	タイマーを停止し、セッションを終了します
get_session_feedback	セッションのトランスクリプトを分析し、フィードバックを提供します

ユースケース

• 就職面接の準備：現実的な面接官のペルソナを相手に練習できます
• プレゼンテーションのリハーサル：メッセージの伝え方や話し方についてフィードバックを得られます
• 難しい会話：職場での難しい話し合いをロールプレイできます
• 自己成長：体系的な自己省察を通じて目標を明確にできます
• 創造的な探求：芸術的、革新的な思考を促すガイド付きセッションを行えます
• 意思決定：焦点を絞った対話を通じて、複雑な選択肢を検討できます
• 日々の振り返り：状況に応じたガイダンスを受けながら、継続的に日記をつけられます

貢献

貢献を歓迎します！以下の分野に関心があります：

• さまざまな役割や業界向けの新しいペルソナ定義
• 特定のユースケース向けの追加セッションフレームワーク
• タイマーやセッション管理機能の強化
• さまざまなMCPクライアントとの統合の改善

ライセンス

GPL-3.0ライセンスです。詳細はLICENSEファイルをご覧ください。

謝辞

AI アシスタントの拡張性を実現するModel Context Protocolフレームワークを使用して構築されています。

変更履歴

CHANGELOG.mdをご覧ください。