DeepLucid3D-MCP
by: MushroomFleet
Unified Cognitive Processing Framework - MCP server for Cline and more
πOverview
Purpose: The DeepLucid3D UCPF Server aims to enhance cognitive analysis and problem-solving through an advanced Model Context Protocol implementation of the Unified Cognitive Processing Framework.
Overview: The DeepLucid3D UCPF Server integrates recursive self-awareness and knowledge categorization, offering structured cognitive tools that facilitate complex problem-solving and creative thinking. It empowers users by assessing cognitive states and generating innovative solutions.
Key Features:
-
Cognitive State Assessment: Identifies current mental states to boost self-awareness and improve problem-solving effectiveness.
-
Knowledge Dimension Mapping: Visualizes knowledge along three dimensions (Awareness, Content, Accessibility) for better understanding and application of information.
-
Recursive Self-Questioning: Encourages critical thinking by challenging initial assumptions to reveal cognitive biases.
-
Creative Perspective Generation: Fosters novel ideas and metaphorical connections to inspire innovative solutions.
-
Problem Decomposition: Breaks down complex problems into manageable parts while maintaining awareness of the whole system.
-
Optional State Management: Supports continuity between sessions for ongoing cognitive analysis and deeper understanding.
DeepLucid3D UCPF Server
A Model Context Protocol (MCP) server implementing the Unified Cognitive Processing Framework (UCPF) for advanced cognitive analysis, creative problem-solving, and structured thinking.
Overview
The DeepLucid3D UCPF Server implements the Unified Cognitive Processing Framework as an MCP server. It combines recursive self-awareness with dimensional knowledge categorization to enhance problem-solving and creative thinking.
The server extends AI capabilities by providing structured cognitive tools that help:
- Assess cognitive states
- Map knowledge dimensions
- Apply recursive self-questioning
- Generate creative perspectives
- Decompose and reintegrate complex problems
Features
Core Capabilities
-
Cognitive State Assessment: Identifies current cognitive states (Dark Inertia, Passion, or Approaching Lucidity) to improve self-awareness during problem-solving.
-
Knowledge Dimension Mapping: Maps knowledge across three dimensions:
- Awareness (Known vs. Unknown)
- Content (Knowns vs. Unknowns)
- Accessibility (Knowable vs. Unknowable)
-
Recursive Self-Questioning: Challenges initial assumptions and identifies potential cognitive biases.
-
Creative Perspective Generation: Produces novel viewpoints and metaphorical thinking to inspire new solutions.
-
Problem Decomposition: Breaks complex problems into manageable components and reintegrates them with awareness of the whole system.
-
Optional State Management: Maintains context between sessions for ongoing analysis.
Setup and Installation
Prerequisites
- Node.js (v14 or higher)
- npm (v6 or higher)
- An environment compatible with the Model Context Protocol
Installation Steps
-
Clone the repository
git clone https://github.com/yourusername/DeepLucid3D-UCPF-Server.git cd DeepLucid3D-UCPF-Server
-
Install dependencies
npm install
-
Build the project
npm run build
-
Configure MCP settings
Add the server to your MCP settings file. For Claude/Cline, this is typically located at:
- For Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) - For VSCode Cline:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
(Linux)
Add the following configuration:
{ "mcpServers": { "ucpf": { "command": "node", "args": ["path/to/DeepLucid3D-MCP/build/index.js"], "env": {}, "disabled": false, "autoApprove": [] } } }
- For Claude Desktop:
-
Restart your MCP-compatible application (Claude, VSCode with Cline, etc.)
Usage
The server exposes three main tools and several resources accessible through MCP:
Tools
-
analyze_problem: Process a problem statement through the full UCPF framework
<use_mcp_tool> <server_name>ucpf</server_name> <tool_name>analyze_problem</tool_name> <arguments> { "problem": "Your problem statement here", "session_id": "optional-session-id", "enable_state": false, "detailed": false } </arguments> </use_mcp_tool>
-
creative_exploration: Generate novel perspectives and connections for a topic
<use_mcp_tool> <server_name>ucpf</server_name> <tool_name>creative_exploration</tool_name> <arguments> { "topic": "Your topic here", "constraints": ["Optional constraint 1", "Optional constraint 2"], "perspective_count": 3, "include_metaphors": true } </arguments> </use_mcp_tool>
-
manage_state: Control state management for UCPF processing
<use_mcp_tool> <server_name>ucpf</server_name> <tool_name>manage_state</tool_name> <arguments> { "action": "enable", // or "disable", "reset", "status" "session_id": "optional-specific-session-id" } </arguments> </use_mcp_tool>
Resources
Access framework documentation:
<access_mcp_resource>
<server_name>ucpf</server_name>
<uri>ucpf://framework/overview</uri>
</access_mcp_resource>
Available resources:
ucpf://framework/overview
: Overview of the UCPF frameworkucpf://framework/cognitive-states
: Guide to cognitive statesucpf://framework/knowledge-dimensions
: Reference for knowledge dimensionsucpf://session/{sessionId}/analysis
: Analysis results for a specific session
Example Use Case: Solving the Sphinx Riddle
Riddle: "What walks on four legs in the morning, two legs in the afternoon, and three legs in the evening?"
Step 1: Enable state management for session persistence
<use_mcp_tool>
<server_name>ucpf</server_name>
<tool_name>manage_state</tool_name>
<arguments>
{
"action": "enable"
}
</arguments>
</use_mcp_tool>
Step 2: Analyze the riddle using the UCPF framework
<use_mcp_tool>
<server_name>ucpf</server_name>
<tool_name>analyze_problem</tool_name>
<arguments>
{
"problem": "What walks on four legs in the morning, two legs in the afternoon, and three legs in the evening?",
"session_id": "sphinx-riddle",
"enable_state": true
}
</arguments>
</use_mcp_tool>
The analysis provides:
- Cognitive state assessment (identifying potential metaphorical thinking)
- Knowledge mapping of knowns and unknowns
- Recursive questions challenging initial assumptions (e.g., "Are we assuming literal legs?")
- Structured perspectives on different interpretations
Step 3: Explore creative perspectives
<use_mcp_tool>
<server_name>ucpf</server_name>
<tool_name>creative_exploration</tool_name>
<arguments>
{
"topic": "Walking with different numbers of legs at different times of day",
"constraints": ["morning", "afternoon", "evening", "four", "two", "three"],
"include_metaphors": true,
"session_id": "sphinx-riddle"
}
</arguments>
</use_mcp_tool>
This exploration reveals:
- Metaphorical interpretation of "legs" as support structures
- Times of day representing stages of life
- Leading to the classic answer: a human, who crawls on four limbs as a baby, walks on two legs as an adult, and uses a cane (third "leg") in old age
Step 4: Review the session analysis
<access_mcp_resource>
<server_name>ucpf</server_name>
<uri>ucpf://session/sphinx-riddle/analysis</uri>
</access_mcp_resource>
This provides the complete analysis journey, showing how structured cognitive processing led to the solution.
Acknowledgments
This project builds upon:
- The Model Context Protocol (MCP) team for creating the foundational protocol enabling AI systems to access external tools and resources
- The Anthropic Claude team for their work on advanced AI systems utilizing MCP
- Contributors to the Unified Cognitive Processing Framework concepts powering this cognitive analysis methodology
- The open-source community whose libraries and tools enable projects like this
License
MIT License
Project Structure
DeepLucid3D-UCPF-Server/
βββ src/
β βββ engine/
β β βββ ucpf-core.ts # Core UCPF processing logic
β β βββ creative-patterns.ts # Creative thinking utilities
β β βββ state-manager.ts # Session state management
β βββ tools/
β β βββ analyze-problem.ts # Problem analysis tool
β β βββ creative-exploration.ts # Creative exploration tool
β βββ index.ts # Main server implementation
βββ build/ # Compiled JavaScript files
βββ package.json # Project dependencies and scripts
βββ README.md # This documentation
Β© 2025 DeepLucid3D UCPF Server