MCP Persona Sessions

mcp角色会话

一个模型上下文协议（MCP）服务器，使人工智能助手能够进行结构化的、由角色驱动的会话，包括面试准备、个人反思和辅导对话。

概述

通过逼真的角色驱动会话改变您的人工智能交互。最初是为模拟面试准备而设计的（在重要会议之前与你的“新老板”练习），这个MCP服务器已经发展成为一个灵活的框架，用于各种引导对话。

无论你是在准备一场关键的演讲，寻求结构化的自我反思，还是想在安全的环境中练习困难的对话，这台服务器都为有意义的、有指导的对话提供了框架。

主要特点

• 🎭 Persona驱动会话：加载详细的角色配置文件，彻底改变人工智能的行为和专业知识
• ⏱️ 内置定时器管理：通过开始、停止和状态检查跟踪会话持续时间
• 📋 结构化框架：具有明确目标和结果的预定义会议模板
• 🔄 自适应流量：对对话中自然出现的内容做出回应的会话
• 📊 会话评估：获得有关绩效和沟通有效性的详细反馈
• 🔒 安全操作：具有路径验证和错误处理功能的安全文件处理

会话类型

会议准备

与现实人物进行对话练习：

• 医疗保健首席信息官：从任务驱动的领导角度进行技术讨论
• 董事会成员：高级别战略对话
• 团队领导：协作规划和决策会议

个人反思

在以下之间流动的自适应日志会话：

• 日常体验处理
• 创造性探索与灵感
• 感恩实践与欣赏
• 生活模式识别和成长规划

自定义会话

为特定需求创建自己的角色和会话框架。

快速开始

先决条件

• Python 3.8+
• MCP兼容的人工智能助手（克劳德桌面等）

安装

1. 克隆存储库：

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

1. 安装依赖项：

pip install fastmcp

1. 设置配置：

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客户端，你可能会使用其他东西。 简单地让克劳德发起一场会议。

“克劳德，用你的工具开一个模拟会议，这次会议是与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

添加自定义角色

创建新 .md 文件在 roles/ 目录包含：

# 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

可用工具

用例

• 工作面试准备：练习真实的面试官角色
• 演示排练：获取有关消息传递和交付的反馈
• 艰难的对话：角色扮演挑战性工作场所讨论
• 个人发展：结构化的自我反思和目标澄清
• 创造性探索：艺术和创新思维指导课程
• 决策：通过集中对话进行复杂的选择
• 日常反思：一致的日志记录实践和适应性指导

贡献

欢迎投稿！感兴趣的领域：

• 不同角色/行业的新角色定义
• 针对特定用例的附加会话框架
• 增强的定时器和会话管理功能
• 针对不同MCP客户端的集成改进

许可证

GPL-3.0许可证-有关详细信息，请参阅许可证文件。

致谢

使用 模型上下文协议 AI助手可扩展性框架。

更新日志

看 更改日志.md.