MCP Cline Personas

🚀 Cline Personality MCP Server

An MCP server for managing .clinerules files, utilizing shared components and role templates.

🚀 Quick Start

The Cline Personality MCP Server is designed to manage .clinerules files effectively. It offers a range of features to handle components and roles, ensuring efficient and reliable operations.

✨ Features

• Component Management: Create, read, update, and delete reusable components.
• Role Templates: Define role templates with mustache variable substitution style.
• Dependency Validation: Ensure that role templates only reference existing components.
• Activation System: Activate roles by writing to the .clinerules file.
• Version Tracking: Track the versions of components and roles.
• File Storage: Store components and roles as JSON files.

📦 Installation

1. Clone the repository.
2. Install the dependencies:

npm install

3. Build the project:

npm run build

💻 Usage Examples

Basic Usage

Managing Components

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

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

// Create a new component
service.setComponent('greeting', 'Welcome message', 'Hello {{name}}!', 1);

// Get a component
const component = service.getComponent('greeting');

// List all components
const components = service.listComponents();

Managing Personas

// Create a new persona
service.setPersona(
  'welcome',
  'Welcome persona',
  '{{greeting}}\nPlease enjoy your stay!',
  1
);

// Activate a persona
service.activatePersona('welcome');

// Get the active persona
const active = service.getActivePersona();

📚 Documentation

File Structure

.cline-personas/
  components/
    [component-name].json
  personas/
    [persona-name].json
src/
  component.ts    # Component class and operations
  persona.ts      # Persona class and template rendering
  service.ts      # Main service implementation
  index.ts        # MCP server entry point
test/             # Unit tests

📄 API Documentation

ComponentPersonaService

The main service class that provides all operations:

• Component Operations:

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

• Persona Operations:

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