MCP Persona Sessions

1# mcp-persona-sessions
2 
3A Model Context Protocol (MCP) server that enables AI assistants to conduct structured, persona-driven sessions including interview preparation, personal reflection, and coaching conversations.
4 
5## Overview
6 
7Transform 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.
8 
9Whether 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.
10 
11## Key Features
12 
13- 🎭 **Persona-Driven Sessions**: Load detailed persona profiles that completely transform AI behavior and expertise
14- ⏱️ **Built-in Timer Management**: Track session duration with start, stop, and status checking
15- 📋 **Structured Frameworks**: Pre-defined session templates with clear goals and outcomes  
16- 🔄 **Adaptive Flow**: Sessions that respond to what emerges naturally in conversation
17- 📊 **Session Evaluation**: Get detailed feedback on performance and communication effectiveness
18- 🔒 **Secure Operation**: Safe file handling with path validation and error handling
19 
20## Session Types
21 
22### Meeting Preparation
23Practice conversations with realistic personas:
24- **Healthcare CIO**: Technical discussions with mission-driven leadership perspective
25- **Board Members**: High-level strategic conversations
26- **Team Leaders**: Collaborative planning and decision-making sessions
27 
28### Personal Reflection
29Adaptive journaling sessions that flow between:
30- Daily experience processing
31- Creative exploration and inspiration
32- Gratitude practice and appreciation
33- Life pattern recognition and growth planning
34 
35### Custom Sessions
36Create your own personas and session frameworks for specific needs.
37 
38## Quick Start
39 
40### Prerequisites
41- Python 3.8+
42- MCP-compatible AI assistant (Claude Desktop, etc.)
43 
44### Installation
45 
461. Clone the repository:
47```bash
48git clone https://github.com/mattjoyce/mcp-persona-sessions.git
49cd mcp-persona-sessions
50```
51 
522. Install dependencies:
53```bash
54pip install fastmcp
55```
56 
573. Set up configuration:
58```bash
59cp config.yaml.example config.yaml
60# Edit config.yaml with your preferences
61```
62 
63### MCP Client Configuration
64 
65Add to your MCP client configuration (e.g., Claude Desktop):
66 
67```json
68{
69  "mcpServers": {
70    "persona-sessions": {
71      "command": "/path/to/venv/python",
72      "args": ["/path/to/mcp-persona-sessions/mcp-persona-sessions.py"],
73      "cwd": "/path/to/mcp-persona-sessions"
74    }
75  }
76}
77```
78 
79## Usage
80 
81### Basic Session Flow
82 
83I use Claude as the mcp client, you might use something else.
84Simple ask claude to initiate a session.
85 
86"Claude, use your tools to run a mock meeting, this meeting is with XXX and is about YYY, duration 10 mins."
87If you have useful documents, include them with the request.
88 
89 
90 
91## Configuration
92 
93### config.yaml
94 
95```yaml
96persona_path: "roles"                           # Directory containing persona files
97session_types_file: "session_types.yaml"       # Session framework definitions
98default_persona_file: "Role-Interviewer-mcp.md" # Fallback persona
99evaluator_persona_file: "Role-Interview-Evaluator.md" # Feedback persona
100```
101 
102### Adding Custom Personas
103 
104Create a new `.md` file in the `roles/` directory with:
105 
106```markdown
107# Your Persona Name
108 
109## Identity and Purpose
110[Define who this persona is and their role]
111 
112## Communication Style
113[How they speak and interact]
114 
115## Expertise Areas
116[What they know and focus on]
117 
118## Goals
119[What they aim to achieve in sessions]
120 
121[Additional sections as needed...]
122```
123 
124### Adding Custom Session Types
125 
126Edit `session_types.yaml` to add new session frameworks:
127 
128```yaml
129session_types:
130  - name: "Your Custom Session"
131    persona: "Your Persona"
132    persona_file: "Role-Your-Persona.md"
133    description: "What this session accomplishes"
134    prerequisites: ["What's needed to start"]
135    duration: 20
136    topics: ["Key areas to explore"]
137    goals: ["Session outcomes"]
138```
139 
140## Project Structure
141 
142```
143mcp-persona-sessions/
144├── mcp-persona-sessions.py    # Main MCP server
145├── timer.py                   # Timer management utilities
146├── config.yaml               # Server configuration
147├── session_types.yaml        # Available session frameworks
148├── roles/                     # Persona definition files
149│   ├── Role-CIO.md
150│   ├── Role-Reflective-Companion.md
151│   ├── Role-Interview-Evaluator.md
152│   └── ...
153├── requirements.txt
154└── README.md
155```
156 
157## Available Tools
158 
159| Tool | Purpose |
160|------|---------|
161| `list_session_frameworks` | Browse available session types and templates |
162| `list_session_personas` | View all available personas |
163| `get_persona_details` | Get full details of a specific persona |
164| `assess_session_readiness` | Check if ready to start a session |
165| `initialize_session` | Begin a structured session |
166| `start_timer` | Start session timer with optional duration |
167| `check_timer_status` | Monitor running timer progress |
168| `stop_timer` | End timer and conclude session |
169| `get_session_feedback` | Analyze session transcript for feedback |
170 
171## Use Cases
172 
173- **Job Interview Prep**: Practice with realistic interviewer personas
174- **Presentation Rehearsal**: Get feedback on messaging and delivery
175- **Difficult Conversations**: Role-play challenging workplace discussions
176- **Personal Development**: Structured self-reflection and goal clarification
177- **Creative Exploration**: Guided sessions for artistic and innovative thinking
178- **Decision Making**: Work through complex choices with focused dialogue
179- **Daily Reflection**: Consistent journaling practice with adaptive guidance
180 
181## Contributing
182 
183Contributions welcome! Areas of interest:
184- New persona definitions for different roles/industries
185- Additional session frameworks for specific use cases
186- Enhanced timer and session management features
187- Integration improvements for different MCP clients
188 
189## License
190 
191GPL-3.0 License - see LICENSE file for details.
192 
193## Acknowledgments
194 
195Built using the [Model Context Protocol](https://modelcontextprotocol.io/) framework for AI assistant extensibility.
196