🎭 Mantras MCP 服务器

基于 Model Context Protocol 的 AI 人格召唤与智能提示工程平台

🚀 快速开始

⚡ 零安装使用（推荐）

直接在 MCP 客户端中配置，无需本地安装：

{
  "mcpServers": {
    "mantras": {
      "command": "npx",
      "args": ["mantras-mcp@latest"]
    }
  }
}

🛠️ 本地开发安装

如需自定义开发或贡献代码：

# 克隆项目
git clone <repository-url>
cd mantras

# 安装依赖
npm install

# 构建项目
npm run build

# 启动 MCP 服务器
npm start

📱 其他配置方式

全局安装

npm install -g mantras-mcp

{
  "mcpServers": {
    "mantras": {
      "command": "mantras"
    }
  }
}

开发模式

{
  "mcpServers": {
    "mantras": {
      "command": "node",
      "args": ["/path/to/mantras/index.js"],
      "cwd": "/path/to/mantras"
    }
  }
}

✨ 核心功能

🎭 AI 人格召唤系统

• 10个专业人格 - 暴躁老哥、自省姐、技术专家、数据分析师等
• 智能召唤 - 基于意图自动选择合适人格
• 会话管理 - 多人格并发对话和状态管理
• 人格合成 - 动态组合多个人格创建专家团队
• 记忆集成 - 每个人格都具备上下文记忆能力

📝 提示工程增强

• 10个核心模板 - 角色提示、链式思考、调试模拟等
• 参数化模板 - 动态参数替换和验证
• 智能推荐 - 基于上下文的模板推荐
• 模板组合 - 多模板协同工作

🧠 智能记忆系统

• 对话记忆 - 自动记录和检索对话历史
• 上下文记忆 - 项目和任务相关信息存储
• 长期记忆 - 跨会话的知识积累
• 记忆分析 - 模式识别和洞察发现

📊 任务管理

• 执行计划 - 复杂任务自动分解
• 任务队列 - 智能任务调度和状态管理
• 进度跟踪 - 实时任务状态监控
• 依赖管理 - 任务间依赖关系处理

🛠️ MCP 工具集

系统工具

• init - 系统初始化和功能概览
• get_project_context - 获取项目上下文信息

资产管理

• list_assets - 列出所有可用资产
• get_asset - 获取特定资产详情

人格系统

• list_personas - 列出所有可用人格
• summon_persona - 召唤指定人格
• analyze_user_intent - 分析用户意图
• get_persona_options - 获取人格选项
• evaluate_persona_match - 评估人格匹配度
• list_active_sessions - 列出活跃会话
• get_session - 获取会话详情
• release_session - 释放会话
• synthesize_persona - 合成新人格

提示工程

• list_mantras - 列出所有提示模板
• apply_mantra - 应用提示模板

任务管理

• create_execution_plan - 创建执行计划
• execute_plan - 执行计划
• get_task_status - 获取任务状态
• update_task_status - 更新任务状态

记忆系统

• manage_memory - 管理记忆系统
• analyze_memory - 分析记忆模式

🏗️ 系统架构

现代化设计

• 依赖注入容器 - 统一服务管理，降低耦合度
• 配置管理系统 - 类型安全的配置，支持环境变量
• 全局错误处理 - 结构化错误分类和监控
• 监控和统计 - 实时性能监控和健康检查

核心组件

src/
├── infrastructure/
│   ├── server/           # MCP 服务器实现
│   ├── config/           # 配置管理
│   └── logging/          # 日志系统
├── core/
│   ├── assets/           # 资产管理
│   ├── personas/         # 人格系统
│   ├── memory/           # 记忆系统
│   └── templates/        # 提示模板
├── tools/                # MCP 工具实现
├── shared/
│   ├── container/        # 依赖注入
│   ├── errors/           # 错误处理
│   └── tools/            # 工具基础设施
└── presentation/
    └── mcp/              # MCP 协议适配

📁 资产结构

人格资产 (10个)

assets/personas/
├── analyst.md           # 数据分析师
├── creative.md          # 创意作家
├── fan-girl.md          # 粉丝妹 - 发现亮点
├── grumpy-bro.md        # 暴躁老哥 - 犀利批评
├── helper-persona.md    # 通用助手
├── mcp-summoner.md      # 人格召唤师
├── product-strategist.md # 小布丁 - 商业分析
├── reflection-sis.md    # 自省姐 - 深度思考
├── tech-expert.md       # 技术专家
└── therapist.md         # 支持专家

提示模板 (10个)

assets/prompt-templates/
├── role-prompting.md           # 角色提示
├── explicit-context.md         # 明确上下文
├── input-output-examples.md    # 输入输出示例
├── iterative-chaining.md       # 迭代式链条
├── debug-simulation.md         # 模拟调试
├── feature-blueprinting.md     # 功能蓝图
├── refactor-guidance.md        # 重构指导
├── ask-alternatives.md         # 寻求替代方案
├── rubber-ducking.md           # 小黄鸭调试法
└── constraint-anchoring.md     # 约束锚定

🔧 开发工具

资产管理

npm run assets:list      # 列出所有资产
npm run assets:validate  # 验证资产完整性
npm run assets:stats     # 查看资产统计
npm run assets:sync      # 同步资产元数据

提示工程

npm run prompt:create    # 创建新提示模板
npm run prompt:manage    # 管理提示模板

人格系统

npm run persona:demo     # 人格系统演示
npm run persona:test     # 人格系统测试

记忆系统

npm run memory:demo      # 记忆系统演示
npm run memory:test      # 记忆系统测试

开发和测试

npm run dev              # 开发模式
npm run test             # 运行测试
npm run test:coverage    # 测试覆盖率
npm run lint             # 代码检查
npm run format           # 代码格式化

📚 使用示例

召唤人格

// 召唤暴躁老哥进行批判性分析
await summon_persona({
  personaId: "grumpy_bro",
  intent: "critical_analysis"
});

// 基于意图智能召唤
await analyze_user_intent({
  userInput: "我需要技术专家帮助",
  context: "代码审查"
});

应用提示模板

// 应用角色提示模板
await apply_mantra({
  templateName: "role-prompting",
  inputs: {
    role: "高级架构师",
    task: "系统设计评审",
    context: "微服务架构"
  }
});

任务管理

// 创建执行计划
await create_execution_plan({
  userRequest: "重构用户认证系统",
  autoDecompose: true
});

📖 文档

用户指南

• 快速开始
• 核心概念
• 人格系统
• 记忆系统

开发者指南

• 系统架构
• API 参考
• MCP 工具

提示工程

• 基础概念
• 核心技巧
• 最佳实践

🤝 贡献

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 开启 Pull Request

开发环境设置

# 克隆项目
git clone <your-fork>
cd mantras

# 安装依赖
npm install

# 开发模式
npm run dev

# 运行测试
npm test

# 构建验证
npm run build

📄 许可证

本项目采用 ISC 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• 🤝 Persona Summoner - 轻量级 AI 人格召唤服务，友联项目
• 🚀 PromptX - 领先的 AI 上下文工程平台，革命性交互设计
• 🔗 Model Context Protocol - 强大的 AI 集成协议
• 📚 《程序员的提示工程实战手册》 - 提示工程最佳实践
• 👥 所有贡献者和用户的反馈和支持

🚀 立即开始: npm install && npm run build && npm start