Content
# Cline Personas MCP Server
An MCP server for managing `.clinerules` files using shared components and persona templates.
## Features
- **Component Management**: Create, read, update and delete reusable components
- **Persona Templates**: Define persona templates with mustache-style variable substitution
- **Dependency Validation**: Ensure persona templates only reference existing components
- **Activation System**: Activate personas by writing to `.clinerules` file
- **Version Tracking**: Track versions for both components and personas
- **File-based Storage**: Store components and personas as JSON files
## Installation
1. Clone the repository
2. Install dependencies:
```bash
npm install
```
3. Build the project:
```bash
npm run build
```
## Usage
### Managing Components
```typescript
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
```typescript
// Create a new persona
service.setPersona(
'welcome',
'Welcome persona',
'{{greeting}}\nPlease enjoy your stay!',
1
);
// Activate a persona
service.activatePersona('welcome');
// Get active persona
const active = service.getActivePersona();
```
## 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 providing 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)`
## Development
Run tests:
```bash
npm test
```
Build the project:
```bash
npm run build
```
Run the MCP server:
```bash
npm start
MCP Store