MCP 服务器

OpenClueo MCP Server

Provides a universal AI personality layer that uses a scientifically-backed Big Five engine to apply consistent character traits and brand voices across MCP-compatible platforms. It allows users to inject custom personality profiles or presets into AI interactions to ensure behavioral consistency.

README

🎭 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

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 Brand	Bold & Innovative (9,8,8,6,3)	Tech startups, innovation messaging

Values shown as (Openness, Conscientiousness, Extraversion, Agreeableness, Neuroticism)

🛠️ Core Tools

`inject_personality`

Apply custom Big Five personality traits to any text:

{
  "text": "Hello, how can I help you today?",
  "personality": {
    "openness": 7,        // Creativity, curiosity (1-10)
    "conscientiousness": 8, // Organization, discipline (1-10)
    "extraversion": 6,     // Sociability, energy (1-10)
    "agreeableness": 9,    // Cooperation, empathy (1-10)
    "neuroticism": 3       // Emotional stability (1-10, lower = more stable)
  },
  "apiKey": "your_api_key"
}

`inject_preset_personality`

Apply predefined personality presets:

{
  "text": "Thanks for your feedback on our product",
  "presetId": "empathetic",
  "apiKey": "your_api_key"
}

`simulate_response`

Generate AI responses with specific personality:

{
  "prompt": "A customer is frustrated with delayed shipping",
  "personality": {
    "openness": 6,
    "conscientiousness": 9,
    "extraversion": 5,
    "agreeableness": 10,
    "neuroticism": 2
  },
  "apiKey": "your_api_key"
}

🧠 Advanced Memory Features

Smart Personality Suggestions

get_memory_suggestions {"context": "customer_email"}
# Returns: "You typically use empathetic + professional for customer emails"

Project-Level Personality

save_project_personality {
  "projectPath": "/work/customer-portal",
  "projectName": "Customer Support Portal",
  "personality": {"openness": 7, "conscientiousness": 9, "extraversion": 6, "agreeableness": 8, "neuroticism": 3}
}

Usage Analytics

get_usage_analytics {"userId": "optional"}
# Returns: Most used personalities, success rates, recommendations

🏢 Enterprise Features

Brand Personality Management

Organization-wide consistency: Ensure all AI interactions match your brand
Department variations: Different personalities for different teams
Compliance monitoring: Track adherence to brand guidelines
Role-based access: Control who can modify brand personalities

Advanced Analytics

Brand performance metrics: Track personality effectiveness
Department usage patterns: See how different teams use AI personalities
ROI measurement: Understand the business impact of consistent AI branding
Compliance reporting: Generate reports for brand guideline adherence

Enterprise API Endpoints

# Apply company brand personality
inject_brand_personality {"organizationId": "company_uuid", "text": "Customer response"}

# Validate brand compliance
validate_brand_compliance {"organizationId": "company_uuid", "text": "Generated response"}

# Deploy organization-wide personality
deploy_brand_personality {"organizationId": "company_uuid", "brandPersonality": {...}}

🔧 Configuration

Environment Variables

# Required
CLUEO_API_URL=https://backend.clueoai.com

# Optional (get at https://api.clueoai.com/)
CLUEO_API_KEY=your_api_key_here

# Server Configuration
MCP_SERVER_NAME=clueo-mcp
MCP_SERVER_VERSION=1.2.20
LOG_LEVEL=info

Big Five Personality Science

Each dimension uses a 1-10 scale based on established psychological research:

Openness (1-10): Creativity, curiosity, openness to new experiences
Conscientiousness (1-10): Organization, dependability, self-discipline
Extraversion (1-10): Sociability, assertiveness, energy level
Agreeableness (1-10): Cooperation, trust, empathy towards others
Neuroticism (1-10): Emotional instability, anxiety (lower = more stable)

🎯 Use Cases

Personal AI Enhancement

Consistent personality across all your AI tools
Context-aware suggestions based on your work patterns
Project-specific personalities for different types of work
Learning from your preferences to improve over time

Enterprise Brand Management

Customer Service: Ensure empathetic, helpful responses across all channels
Sales Team: Maintain enthusiastic, professional communication
Technical Support: Provide analytical, precise assistance
Marketing: Consistent brand voice in all AI-generated content

Developer Integration

API-first design: Integrate personality into any application
Cross-platform compatibility: Works with any MCP-compatible AI
Real-time processing: Personality applied before AI generation
Scalable architecture: From personal use to enterprise deployment

📊 API Rate Limits & Pricing

Plan	Monthly API Calls	Price	Best For
Free	100 calls	$0	Personal exploration
Dev+	5,000 calls	$25	Individual developers
Operator	50,000 calls	$149	Small teams
Enterprise	Custom	Contact	Large organizations

Get your API key →

🤝 Contributing

We welcome contributions to the open source OpenClueo MCP Server!

Fork the repository
Create your feature branch (git checkout -b feature/amazing-personality)
Commit your changes (git commit -m 'Add amazing personality feature')
Push to the branch (git push origin feature/amazing-personality)
Open a Pull Request

📄 License

MIT License - see LICENSE for details.

Note: The core personality injection technology is patent-pending. This open source implementation provides basic functionality, while advanced enterprise features require a commercial license.

🔗 Links

🌟 Why OpenClueo MCP Changes Everything

Before OpenClueo MCP:

❌ Generic, inconsistent AI responses across platforms
❌ No brand personality control for organizations
❌ Manual personality prompting for every interaction
❌ No learning or memory of personality preferences

With OpenClueo MCP:

✅ Universal personality protocol across ALL AI platforms
✅ Scientific Big Five model with precise numerical control
✅ Enterprise brand consistency with compliance monitoring
✅ Adaptive memory system that learns your preferences
✅ Real-time personality injection before AI processing
✅ Patent-protected innovation with open source accessibility

🚀 What's Next?

OpenClueo MCP represents the first step toward universal AI personality standardization. As the ecosystem grows, we're building:

Personality Marketplace: Buy, sell, and share personality presets
Industry-Specific Templates: Healthcare AI, Legal AI, Financial AI personalities
Advanced Analytics: Deep insights into AI personality performance
Multi-Modal Support: Personality for voice, video, and other AI modalities

Join the AI personality revolution. 🎭✨

Ready to give your AI a consistent, memorable personality across every platform?

Get Started Now →

Made with ❤️ by Clueo Foundation