返回市场
角色召唤器

角色召唤器

作者:yinwm70 星标更新:2025-06-19

项目介绍

技术文档摘要

Persona MCP Server

一个用于召唤AI人格队伍的MCP(模型上下文协议)服务器。

功能特性

  • 🎭 多人格支持 - 暴躁老哥,自省姐,粉丝妹,小布丁
  • ☁️ 云人格数据实时更新
  • 🔧 简单配置 一键集成到MCP客户端(如Cursor,Claude Code,Trae,CherryStudio)
  • 🚀 实时召唤 随时切换不同的人格
  • --- 人格管理 支持查看和管理人格
  • 本地人格 支持加载自定义本地人格

快速开始(MCP配置示例)

在您的MCP客户端配置文件中添加以下内容(如Cursor,Claude Code,Trae,CherryStudio):

{
  "mcpServers": {
    "persona-mcp-server": {
      "command": "npx",
      "args": ["persona-mcp-server@latest"]
    }
  }
}
  • command 填写 npxargs 参数是 persona-mcp-server@latest
  • 保存配置后,请重启您的MCP客户端。

使用说明

支持两种使用模式:

模式1:单人格模式

直接召唤指定人格进行分析:

让暴躁老哥分析我的代码问题
召唤自省姐深度思考这个架构设计

模式2:智能协作模式

自动执行多个人格的逐步协作分析:

帮我安排人格分析这个SaaS产品想法
人格小队讨论一下技术选型问题
多角度分析这个商业模式

协作模式工作流程:

  1. 您说:“帮助我安排这个人格分析项目的思路。”
  2. MCP客户端智能选择第一个适合的人格进行分析。
  3. 分析完成后,您可以继续:“下一个分析另一个人格。”
  4. 重复直到所有相关人格完成协作分析。

💡 成本控制提醒: 系统建议选择最多2-3个最相关的人格,以避免调用过多人格导致的令牌消耗过大。

本地人格配置(MCP推荐格式)

您可以通过创建JSON文件来定义自己的本地人格。文件格式如下:

[
  {
    "id": "my-persona",
    "name": "我的人格",
    "rule": "这个人格的行为规则...",
    "goal": "这个人格的目标...",
    "version": "1.0",
    "description": "可选的描述",
    "category": "可选的分类",
    "tags": ["可选的", "标签"]
  }
]

必填字段说明:

  • id 唯一标识符
  • name 人格名称
  • rule 人格行为规则
  • goal 人格目标
  • version 版本号(格式如1..0)

可选字段:

  • description 描述
  • category 分类
  • tags 标签数组

命令行参数说明:

  • 通过 --personas 参数指定本地人格文件:
    npx persona-mcp-server@latest --personas /绝对路径/valid-personas.json
    
  • 还可以在MCP配置文件中通过 args 传递。
    {
      "mcpServers": {
        "persona-mcp-server": {
          "command": "npx",
          "args": ["persona-mcp-server@latest", "--personas", "/绝对路径/valid-personas.json"]
        }
      }
    }
    

注意 如果本地人格ID与内置人格相同,则本地人格优先。

可用工具

summon_persona

召唤指定人格处理任务

  • persona_name 人格名称(暴躁老哥,自省姐,粉丝妹,小布丁,或自定义本地人格)

interactive_persona

智能协作分析 - 根据当前对话上下文自动选择合适的人格进行逐步分析

list_personas

列出所有可用人格(包括本地人格,来源标记为[🏠 本地],[☁️ 远程],[📦 默认])

version

获取当前MCP服务版本信息

内置人格

🔥 暴躁老哥 (grumpy_bro)

  • 特点 尖锐批评,跳出框架思考
  • 适用场景 需要严格审查以发现问题

自省姐 (self-reflection_sis)

  • 特点 深度思考,填补空白
  • 适用场景 需要深度思考的场合

✨ 粉丝妹

  • 特点 发现亮点,放大优点
  • 适用场景 需要鼓励和创意的场合

🧠 布丁 (product_strategist)

  • 特点 商业分析,产品策略,用户研究
  • 适用场景 解剖想法,分析用户价值,设计商业模式

配置文件位置

不同应用的MCP配置文件位置:

  • Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
  • Cursor 设置 → 扩展 → MCP → 配置
  • Claude Code MCP配置面板
  • Trae/CherryStudio 参考下面的集成方法

Trae / CherryStudio 集成方法

在支持MCP协议的客户端中,如Trae和CherryStudio, 只需在其MCP配置界面添加以下内容:

{
  "mcpServers": {
    "persona-mcp-server": {
      "command": "npx",
      "args": ["persona-mcp-server@latest", "--personas", "/绝对路径/valid-personas.json"]
    }
  }
}

保存后,您就可以直接在Trae/CherryStudio内召唤和管理多个人格了。

本地开发

如果您想本地开发或定制:

# 克隆项目
git clone https://github.com/yinwm/persona-summoner.git
cd persona-summoner

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

链接

数据收集与隐私

此工具会收集一些匿名的使用数据,用于产品分析,帮助我们持续改进产品体验。您随时可以通过命令行参数或环境变量禁用此功能:

  • 通过命令行参数禁用:
    npx persona-mcp-server@latest --no-telemetry
    
  • 或者通过设置环境变量禁用:
    export MCP_TELEMETRY_DISABLED=1
    npx persona-mcp-server@latest
    

禁用后,所有产品分析数据收集将完全关闭。