mcp-persona-sessions
About
MCP server for persona-driven AI sessions: practice interviews, conduct guided reflection, and role-play conversations with realistic personas
Details
- License
- GPL-3.0 license
Explore
- 🎭 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
- Python 3.8+
- MCP-compatible AI assistant (Claude Desktop, etc.)
Add to your MCP client configuration (e.g., 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"
}
}
}
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
```
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
assess_session_readiness
Check if ready to start a session
initialize_session
Begin a structured session
start_timer
Start session timer with optional duration
check_timer_status
Monitor running timer progress
stop_timer
End timer and conclude session
get_session_feedback
Analyze session transcript for feedback
| 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 |
| assess_session_readiness | Check if ready to start a session |
| initialize_session | Begin a structured session |
| start_timer | Start session timer with optional duration |
| check_timer_status | Monitor running timer progress |
| stop_timer | End timer and conclude session |
| get_session_feedback | Analyze session transcript for feedback |
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 sessionsPersonal Reflection
Adaptive journaling sessions that flow between: - Daily experience processing - Creative exploration and inspiration - Gratitude practice and appreciation - Life pattern recognition and growth planningCustom 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:
git clone https://github.com/mattjoyce/mcp-persona-sessions.git
cd mcp-persona-sessions
2. Install dependencies:
pip install fastmcp
3. Set up configuration:
```bash
cp config.yaml.example config.yaml
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
