ClueoMCP

ClueoMCP is a Node-based MCP server that exposes OpenClueo’s universal AI personality framework. It integrates with clients and IDEs to inject branded Big Five personality profiles into AI interactions, enabling consistent personality behavior across tools like Claude Desktop, Cursor, Windsurf, and VS Code. You can start by installing the MCP CLI globally, then configure an MCP server entry that points to the OpenClueo MCP package. Use the provided environment variables to connect to the Clueo backend and optionally provide an API key for advanced features. Tools available include injecting custom personalities, applying predefined presets, and simulating responses with specified personality traits, all designed to ensure brand-consistent communication across platforms.

Prerequisites:

• Node.js 18+ (runtime for the MCP CLI and server)
• npm (comes with Node.js)
• Access to the OpenClueo MCP service (optional API key for advanced features)

Installation steps:

1. Install the MCP CLI globally

npm install -g @openclueo/mcp

2. Verify installation

@openclueo/mcp --version

3. Install and run the server configuration locally (example using the Quick Start config from the README):

# Ensure you have the mcpServers entry configured in your project or an appropriate global config

4. Run or integrate with your IDE as described in IDE integration sections of the README (Claude Desktop, Cursor, Windsurf, VS Code). You can also follow the source installation path if you prefer building from repository:

git clone https://github.com/ClueoFoundation/ClueoMCP.git
cd ClueoMCP
npm install
npm run build

Tips and notes:

• Use CLUEO_API_URL and CLUEO_API_KEY to connect to Clueo’s backend when you need advanced features; otherwise basic usage works with the API URL placeholder.
• The server name in your mcp_config can be any unique identifier (examples use clueo-mcp).
• When integrating into IDEs, ensure environment variables are properly set in the respective configuration blocks (Claude Desktop, Cursor, Windsurf, VS Code).
• If you encounter networking or authentication issues, double-check the API URL and key, and verify the MCP client is allowed to reach the Clueo backend.
• The npm package name is @openclueo/mcp and is the primary entry point for running the MCP server through Node.js tooling.