mcp-persona-sessions

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

概述

通过现实的角色驱动会话来改变您的AI交互体验。最初设计用于模拟面试准备（在重要会议前与“新老板”练习），此MCP服务器已演变为各种引导对话的灵活框架。

无论您是在准备关键演示、寻求结构化的自我反思，还是希望在一个安全的环境中练习困难对话，该服务器都提供了有意义的引导对话框架。

主要功能

• 🎭 角色驱动的会话：加载详细的角色配置文件，完全改变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
# 根据您的偏好编辑config.yaml

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"
    }
  }
}

使用方法

基本会话流程

我使用Claude作为MCP客户端，您可能使用其他工具。 简单地请求Claude启动一个会话。

"Claude，使用你的工具运行一个模拟会议，这个会议是与XXX关于YYY的，持续10分钟。" 如果您有有用的文档，请在请求中包含它们。

配置

config.yaml

persona_path: "roles"                           # 包含角色文件的目录
session_types_file: "session_types.yaml"       # 会话框架定义
default_persona_file: "Role-Interviewer-mcp.md" # 默认角色
evaluator_persona_file: "Role-Interview-Evaluator.md" # 反馈角色

添加自定义角色

在roles/目录下创建一个新的.md文件：

# 您的角色名称

## 身份和目的
[定义这个角色是谁以及他们的职责]

## 沟通风格
[他们如何说话和互动]

## 专业领域
[他们知道什么并专注于什么]

## 目标
[他们在会话中想要实现什么]

[根据需要添加更多部分...]

添加自定义会话类型

编辑session_types.yaml以添加新的会话框架：

session_types:
  - name: "您的自定义会话"
    persona: "您的角色"
    persona_file: "Role-Your-Persona.md"
    description: "这个会话完成什么"
    prerequisites: ["开始需要什么"]
    duration: 2 0
    topics: ["要探索的关键领域"]
    goals: ["会话成果"]

项目结构

mcp-persona-sessions/
├── mcp-persona-sessions.py    # 主MCP服务器
├── timer.py                   # 计时器管理实用程序
├── config.yaml               # 服务器配置
├── session_types.yaml        # 可用的会话框架
├── roles/                     # 角色定义文件
│   ├── 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助手扩展性。