AI导哈

AI角色会话框架

一个基于Model Context Protocol (MCP)的服务，支持AI助手进行结构化、角色驱动的会话，包括面试准备、个人反思和辅导对话。

  • by mattjoyce
  • Python
  • 本地部署
  • 13 星标
  • 更新于
在 GitHub 查看 mattjoyce/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

可用工具

工具 目的
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许可证-有关详细信息，请参阅许可证文件。

致谢

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

更新日志

看 更改日志.md.

相关 MCP