mcp-cline-personas

🚀 Cline 人格 MCP 服务器

Cline 人格 MCP 服务器是一个专门用于管理 .clinerules 文件的 MCP 服务器，它借助共享组件和角色模板，为用户提供高效的文件管理体验。

🚀 快速开始

Cline 人格 MCP 服务器能帮助你轻松管理 .clinerules 文件。以下是快速开始的步骤：

1. 克隆仓库
2. 安装依赖：

npm install

3. 构建项目：

npm run build

✨ 主要特性

• 组件管理：支持创建、读取、更新和删除可重用组件，方便你灵活管理组件资源。
• 角色模板：允许你定义带有 mustache 变量替换风格的角色模板，实现个性化的角色定制。
• 依赖验证：确保角色模板仅引用现有组件，避免因引用不存在的组件而导致的错误。
• 激活系统：通过写入 .clinerules 文件激活角色，快速启用所需角色。
• 版本跟踪：可以跟踪组件和角色的版本，方便你进行版本管理和回溯。
• 文件存储：将组件和角色存储为 JSON 文件，便于数据的存储和读取。

📦 安装指南

1. 克隆仓库。
2. 安装依赖：

npm install

3. 构建项目：

npm run build

💻 使用示例

基础用法

import { ComponentPersonaService } from './src/service';

const service = new ComponentPersonaService(process.cwd());

// 创建新组件
service.setComponent('greeting', '欢迎消息', '你好 {{name}}！', 1);

// 获取组件
const component = service.getComponent('greeting');

// 列出所有组件
const components = service.listComponents();

高级用法

// 创建新角色
service.setPersona(
  'welcome',
  '欢迎角色',
  '{{greeting}}\n请享受您的停留！',
  1
);

// 激活角色
service.activatePersona('welcome');

// 获取活动角色
const active = service.getActivePersona();

📚 详细文档

文件结构

.cline-personas/
  components/
    [component-name].json
  personas/
    [persona-name].json
src/
  component.ts    # 组件类和操作
  persona.ts      # 角色类和模板渲染
  service.ts      # 主服务实现
  index.ts        # MCP 服务器入口点
test/             # 单元测试

📄 API 文档

ComponentPersonaService

主要的服务类，提供所有操作：

• 组件操作：

  • setComponent(name, description, text, version)
  • getComponent(name)
  • listComponents()
  • deleteComponent(name)

• 角色操作：

  • setPersona(name, description, template, version)
  • getPersona(name)
  • listPersonas()
  • deletePersona(name)
  • activatePersona(name)
  • getActivePersona()
  • renderPersona(name)