README.md•8.05 kB
# 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.
## What is it?
The DeepLucid3D UCPF Server is an implementation of the Unified Cognitive Processing Framework as an MCP server. It combines recursive self-awareness with dimensional knowledge categorization to provide a powerful approach to problem-solving and creative thinking.
This 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
## What it does
The UCPF Server enables advanced cognitive processing through several key features:
### Core Capabilities
1. **Cognitive State Assessment**: Identifies current cognitive states (Dark Inertia, Passion, or Approaching Lucidity) to improve self-awareness during problem-solving.
2. **Knowledge Dimension Mapping**: Maps knowledge across three dimensions:
- Awareness (Known vs. Unknown)
- Content (Knowns vs. Unknowns)
- Accessibility (Knowable vs. Unknowable)
3. **Recursive Self-Questioning**: Challenges initial assumptions and identifies potential cognitive biases.
4. **Creative Perspective Generation**: Produces novel viewpoints and metaphorical thinking to inspire new solutions.
5. **Problem Decomposition**: Breaks complex problems into manageable components and reintegrates them with awareness of the whole system.
6. **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
1. **Clone the repository**
```bash
git clone https://github.com/yourusername/DeepLucid3D-UCPF-Server.git
cd DeepLucid3D-UCPF-Server
```
2. **Install dependencies**
```bash
npm install
```
3. **Build the project**
```bash
npm run build
```
4. **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:
```json
{
"mcpServers": {
"ucpf": {
"command": "node",
"args": ["path/to/DeepLucid3D-MCP/build/index.js"],
"env": {},
"disabled": false,
"autoApprove": []
}
}
}
```
5. **Restart your MCP-compatible application** (Claude, VSCode with Cline, etc.)
## How to Use
The server exposes three main tools and several resources that can be accessed through MCP:
### Tools
1. **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>
```
2. **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>
```
3. **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 framework
- `ucpf://framework/cognitive-states`: Guide to cognitive states
- `ucpf://framework/knowledge-dimensions`: Reference for knowledge dimensions
- `ucpf://session/{sessionId}/analysis`: Analysis results for a specific session
## Example Use Case: Using UCPF to Solve a Riddle
Let's solve the classic 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 will provide:
- Cognitive state assessment (likely identifying potential metaphorical thinking)
- Knowledge mapping of what we know and don't know
- Recursive questions to challenge initial assumptions (e.g., "Are we assuming literal legs?")
- Structured perspectives on different interpretations
### Step 3: Explore creative perspectives to find the solution
```
<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 might reveal:
- The metaphorical interpretation of "legs" as support structures
- The metaphorical interpretation of times of day as 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 the framework led to the solution through structured cognitive processing.
## Acknowledgments
This project stands on the shoulders of giants:
- The **Model Context Protocol (MCP)** team for creating the foundational protocol that enables AI systems to access external tools and resources
- The **Anthropic Claude** team for their work on advanced AI systems capable of utilizing MCP
- Contributors to the **Unified Cognitive Processing Framework** concepts that power the cognitive analysis methodology
- The open-source community whose libraries and tools make projects like this possible
## 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