Knowledge Graph Mia
Mia's MCP server enabling persistent memory for AI models through a local knowledge graph
Ask AI about Knowledge Graph Mia
Powered by Claude Β· Grounded in docs
I know everything about Knowledge Graph Mia. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
COAIA Memory - Creative-Oriented AI Assistant Memory System
MCP server implementing structural tension charts and advancing pattern support based on Robert Fritz's creative methodology
What is COAIA Memory?
COAIA Memory extends traditional knowledge graphs with structural tension charts - a powerful framework for organizing creative processes around desired outcomes rather than problem-solving. Based on Robert Fritz's structural tension methodology, it helps AI assistants maintain creative orientation and support advancing patterns.
Current Version: v2.3.0 (LLM-Intelligent Enhancement)
Key Features
π― Structural Tension Charts
- Desired Outcomes: Clear, specific results you want to create
- Current Reality: Honest assessment of where you are now
- Structural Tension: The unresolved tension between current reality and desired outcome that naturally seeks resolution
- Action Steps: Strategic secondary actions - intermediary end results that advance toward the primary goal
- Due Dates: Time organization that creates momentum
π Telescoping Support
- Break down complex action steps into detailed sub-charts
- Proper due date inheritance from parent steps
- Hierarchical navigation between overview and details
- Maintains structural tension at every level
π Advancing Pattern Tracking
- Completed action steps become part of current reality, changing the structural dynamic
- Each completion advances the system toward equilibrium (desired outcome)
- Success creates new structural tension for continued advancement
- Prevents oscillating patterns through proper structural design
π£οΈ Natural Language Ready
- Conversational patterns documented for intuitive interaction
- Creative-oriented language (focus on creation vs problem-solving)
- AI assistants can guide users through structural tension exercises
π Traditional Knowledge Graph
- Full entity, relation, and observation management
- Search and retrieval capabilities
- Compatible with existing MCP knowledge graph workflows
Installation & Usage
As NPX Package
npx coaia-memory --memory-path ./my-charts.jsonl
In Claude Desktop Config
{
"mcpServers": {
"coaia-memory": {
"command": "npx",
"args": ["-y", "coaia-memory", "--memory-path", "/path/to/your/charts.jsonl"],
"autoapprove": [
"create_structural_tension_chart",
"telescope_action_step",
"mark_action_complete",
"get_chart_progress",
"list_active_charts",
"create_entities",
"create_relations",
"add_observations"
]
}
}
}
Local Development
git clone <repository>
cd coaia-memory
npm install
npm run build
Core Tools
Structural Tension Chart Management
create_structural_tension_chart- Create new chart with outcome, reality, and action stepstelescope_action_step- Break down action steps into detailed sub-chartsmark_action_complete- Complete actions and update current realityget_chart_progress- Monitor chart advancementlist_active_charts- Overview of all active charts
Traditional Knowledge Graph Operations
create_entities- Add new entities (people, concepts, events)create_relations- Connect entities with relationshipsadd_observations- Record new information about entities- Plus full CRUD operations for entities, relations, and observations
Example Usage
Creating a Chart
// Natural language: "I want to learn Python web development in 6 weeks"
{
"desiredOutcome": "Learn Python web development",
"currentReality": "I know basic Python but no web frameworks",
"dueDate": "2025-09-15T00:00:00Z",
"actionSteps": [
"Complete Django tutorial",
"Build practice project",
"Deploy something live"
]
}
Telescoping Detail
// Natural language: "Break down the Django tutorial step"
{
"actionStepName": "chart_123_action_1",
"newCurrentReality": "Never used Django, familiar with Python basics"
}
Tracking Progress
// Natural language: "I finished the Django tutorial"
{
"actionStepName": "chart_123_action_1"
}
Creative Orientation Principles
Focus on Creation, Not Problem-Solving
- Use: "I want to create...", "My desired outcome is..."
- Avoid: "I need to fix...", "The problem is...", "I want to stop..."
Structural Tension Awareness
- Always pair desired outcomes with current reality to create structural tension
- This unresolved tension naturally seeks resolution through advancement
- Action steps are strategic intermediary results that change the structural dynamic
- Completed actions flow into current reality, creating new tension for continued advancement
Advancing Patterns
- Success builds on success
- Completed actions become part of current reality
- Momentum creates natural progression toward goals
Development & Testing
Build & Test
npm install
npm run build
Test Environment
cd test-environment
claude-code # Launch with pre-configured MCP setup
Release Status
β Validated in v2.0.0-rc.1
- Core Structural Tension Charts: Fully functional with proper entity relationships
- Telescoping Support: Action steps break down into sub-charts with due date inheritance
- Advancing Pattern Tracking: Completions flow into current reality, system advances naturally
- MCP Integration: All tools working correctly in Claude Code CLI environment
- Real-World Testing: Validated with actual user interactions in test environment
Next Milestone
Guided Chart Creation: Transform from passive storage to active coaching system that helps users create meaningful structural tension charts with proper creative orientation validation.
Architecture
Enhanced Entity Types
structural_tension_chart- Container for chart componentsdesired_outcome- What you want to createcurrent_reality- Where you are nowaction_step- Strategic actions with due dates
Creative Relations
creates_tension_with- Between current reality and desired outcomeadvances_toward- Action steps advancing toward outcomestelescopes_into- Hierarchical chart relationshipsflows_into- Completed actions updating reality
Metadata Support
- Due dates and completion tracking
- Chart hierarchy and telescoping relationships
- Creative phases (germination, assimilation, completion)
- Timestamps and progress metrics
Credits
- Author: J.Guillaume D.-Isabelle jgi@jgwill.com (https://github.com/jgwill)
- Methodology: Robert Fritz - Structural Tension (https://robertfritz.com)
- Foundation: Shane Holloman - Original MCP Knowledge Graph
- License: MIT
Philosophy
COAIA Memory embodies the principle that structure determines behavior. By organizing memory around structural tension rather than problem-solving patterns, it naturally supports creative advancement and helps users build the life they want to create.
The system recognizes that structural tension is the fundamental organizing principle of the creative process - not a problem to be solved, but a generative force to be harnessed.
