mattjoyce/mcp-persona-sessions

A Model Context Protocol (MCP) server that enables AI assistants to conduct structured, persona-driven sessions including interview preparation, personal reflection, and coaching conversations.
Overview
Transform your AI interactions with realistic persona-driven sessions. Originally designed for mock interview preparation (practice with your "new boss" before that important meeting), this MCP server has evolved into a flexible framework for guided conversations of all kinds.
Whether you're preparing for a crucial presentation, seeking structured self-reflection, or wanting to practice difficult conversations in a safe environment, this server provides the framework for meaningful, guided dialogue.
Key Features
- 🎭 **Persona-Driven Sessions**: Load detailed persona profiles that completely transform AI behavior and expertise
- ⏱️ **Built-in Timer Management**: Track session duration with start, stop, and status checking
- 📋 **Structured Frameworks**: Pre-defined session templates with clear goals and outcomes
- 🔄 **Adaptive Flow**: Sessions that respond to what emerges naturally in conversation
- 📊 **Session Evaluation**: Get detailed feedback on performance and communication effectiveness
- 🔒 **Secure Operation**: Safe file handling with path validation and error handling
Session Types
Meeting Preparation
Practice conversations with realistic personas:
- **Healthcare CIO**: Technical discussions with mission-driven leadership perspective
- **Board Members**: High-level strategic conversations
- **Team Leaders**: Collaborative planning and decision-making sessions
Personal Reflection
Adaptive journaling sessions that flow between:
- Daily experience processing
- Creative exploration and inspiration
- Gratitude practice and appreciation
- Life pattern recognition and growth planning
Custom Sessions
Create your own personas and session frameworks for specific needs.
Quick Start
Prerequisites
- Python 3.8+
- MCP-compatible AI assistant (Claude Desktop, etc.)
Installation
1. Clone the repository:
2. Install dependencies:
3. Set up configuration:
MCP Client Configuration
Add to your MCP client configuration (e.g., Claude Desktop):
Usage
Basic Session Flow
I use Claude as the mcp client, you might use something else.
Simple ask claude to initiate a session.
"Claude, use your tools to run a mock meeting, this meeting is with XXX and is about YYY, duration 10 mins."
If you have useful documents, include them with the request.
Configuration
config.yaml
Adding Custom Personas
Create a new .md file in the roles/ directory with:
Adding Custom Session Types
Edit session_types.yaml to add new session frameworks:
Project Structure
Available Tools
| Tool | Purpose |
|------|---------|
| list_session_frameworks | Browse available session types and templates |
| list_session_personas | View all available personas |
| get_persona_details | Get full details of a specific persona |