trackmcp
Back to directory
mushroomfleet

DeepLucid3D-MCP

View on GitHub

Unified Cognitive Processing Framework - MCP server for Cline and more

13 stars TypeScriptDeveloper Kits Updated Oct 5, 2025

Documentation

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:

    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:

      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

      code
      ucpf
         analyze_problem
         
         {
           "problem": "Your problem statement here",
           "session_id": "optional-session-id",
           "enable_state": false,
           "detailed": false
         }

      2. creative_exploration: Generate novel perspectives and connections for a topic

      code
      ucpf
         creative_exploration
         
         {
           "topic": "Your topic here",
           "constraints": ["Optional constraint 1", "Optional constraint 2"],
           "perspective_count": 3,
           "include_metaphors": true
         }

      3. manage_state: Control state management for UCPF processing

      code
      ucpf
         manage_state
         
         {
           "action": "enable", // or "disable", "reset", "status"
           "session_id": "optional-specific-session-id"
         }

      Resources

      Access framework documentation:

      code
      ucpf
      ucpf://framework/overview

      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

      code
      ucpf
      manage_state
      
      {
        "action": "enable"
      }

      Step 2: Analyze the riddle using the UCPF framework

      code
      ucpf
      analyze_problem
      
      {
        "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
      }

      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

      code
      ucpf
      creative_exploration
      
      {
        "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"
      }

      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

      code
      ucpf
      ucpf://session/sphinx-riddle/analysis

      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

      code
      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

      See Also

      Frequently asked questions

      What is DeepLucid3D-MCP?

      DeepLucid3D-MCP is Unified Cognitive Processing Framework - MCP server for Cline and more

      How do I install DeepLucid3D-MCP?

      Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

      Is DeepLucid3D-MCP open source?

      Yes — it is hosted on GitHub at https://github.com/mushroomfleet/deeplucid3d-mcp and has 13 stars.

      Related MCP tools

      Run your own MCP server? See who uses it and what to fix.

      Measure it with TrackMCP