README.md
The Universal AI Personality Layer for Model Context Protocol
🎭 OpenClueo MCP Server
The Universal AI Personality Layer for Model Context Protocol
Patent-pending technology that transforms any AI into a consistent, branded personality across all platforms.
Transform any MCP-compatible AI with rich, consistent personalities powered by OpenClueo's scientifically-backed Big Five personality engine. The first universal AI personality protocol that works across Claude Desktop, Cursor, Windsurf, VS Code, and any MCP-compatible platform.
⚡ Quick Start
# Install from npm
npm install -g @openclueo/mcp
# Add to your IDE (Claude Desktop example)
{
"mcpServers": {
"clueo-mcp": {
"command": "@openclueo/mcp",
"env": {
"CLUEO_API_URL": "https://backend.clueoai.com",
"CLUEO_API_KEY": "your_api_key_here"
}
}
}
}
# Start using personalities instantly!
inject_preset_personality "Hello, how can I help?" "professional"
inject_personality "Write an email" {"openness": 8, "conscientiousness": 9}
🌟 What Makes OpenClueo MCP Revolutionary?
**🎯 Universal AI Personality Protocol**
The first standardized method for applying consistent personality traits across ALL AI platforms:
- Cross-Platform: Same personality in Claude, ChatGPT, Cursor, Windsurf, VS Code
- Real-Time: Personality applied before AI processing, not after
- Scientific: Big Five psychological model with numerical precision (1-10 scale)
- Consistent: Identical personality behavior across all your AI tools
**🏢 Enterprise Brand Personality**
Patent-pending technology for organization-wide AI brand consistency:
- Brand Compliance: Ensure all company AI interactions match your brand voice
- Department Variations: Customer service (empathetic), Sales (enthusiastic), Engineering (analytical)
- Context Awareness: Automatically adapts personality based on communication context
- Analytics: Track brand personality performance and ROI across your organization
**🧠 Adaptive Memory System**
AI that learns YOUR personality preferences:
- Smart Suggestions: "You often use empathetic + professional for customer emails"
- Project Memory: Save default personalities for specific projects
- Usage Analytics: Understand your personality patterns and success rates
- Context Learning: System improves recommendations based on your patterns
🚀 Installation & Setup
Prerequisites
- Node.js 18+
- An MCP-compatible client (Claude Desktop, Cursor, Windsurf, VS Code, etc.)
- Get your API key (optional for basic use)
**Option 1: NPM Install (Recommended)**
# Install globally
npm install -g @openclueo/mcp
# Verify installation
@openclueo/mcp --version
**Option 2: From Source**
git clone https://github.com/ClueoFoundation/ClueoMCP.git
cd ClueoMCP
npm install
npm run build
🔌 IDE Integration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"clueo-mcp": {
"command": "@openclueo/mcp",
"env": {
"CLUEO_API_URL": "https://backend.clueoai.com",
"CLUEO_API_KEY": "your_api_key_here"
}
}
}
}
Cursor IDE
- Settings → Features → Model Context Protocol
- Add Server:
- Name:
clueo-mcp - Command:
@openclueo/mcp - Environment:
CLUEO_API_URL=https://backend.clueoai.com
- Name:
Windsurf IDE
- Settings → Advanced → Cascade
- Add custom server:
{
"mcpServers": {
"clueo-mcp": {
"command": "@openclueo/mcp",
"env": {
"CLUEO_API_URL": "https://backend.clueoai.com",
"CLUEO_API_KEY": "your_api_key_here"
}
}
}
}
VS Code (with MCP extension)
Install the MCP extension, then add the OpenClueo server to your workspace settings.
🎭 Personality Presets
8 scientifically-crafted personalities for common scenarios:
| Preset | Personality Traits | Best For |
|---|---|---|
| Professional | Balanced (6,8,6,7,3) | Business communications, formal emails |
| Creative | High Openness (9,6,7,6,4) | Brainstorming, content creation, marketing |
| Empathetic | High Agreeableness (7,7,6,9,3) | Customer support, counseling, HR |
| Analytical | High Conscientiousness (8,9,5,6,2) | Technical docs, research, analysis |
| Enthusiastic | High Extraversion (8,7,9,7,2) | Sales, presentations, team motivation |
| Casual Friend | Balanced & Relaxed (7,5,7,8,3) | Informal chats, internal communication |
| Luxury Brand | Sophisticated (6,9,6,6,2) | Premium brand voice, high-end clients |
| **Startup B |
Tools (2)
inject_preset_personalityApplies a predefined personality preset to the current AI interaction.inject_personalityApplies a custom personality based on Big Five trait scores.Environment Variables
CLUEO_API_URLrequiredThe backend URL for the OpenClueo service.CLUEO_API_KEYAPI key for accessing OpenClueo services.Configuration
claude_desktop_config.json
{"mcpServers": {"clueo-mcp": {"command": "@openclueo/mcp", "env": {"CLUEO_API_URL": "https://backend.clueoai.com", "CLUEO_API_KEY": "your_api_key_here"}}}}Try it
→Inject the 'professional' personality preset and help me draft a formal business email.
→Apply a personality with high openness and high conscientiousness to help me brainstorm creative marketing ideas.
→Use the 'empathetic' personality preset to rewrite this customer support response.
→Set my AI personality to be highly analytical for this technical research task.