North Star MCP

Read-only MCP server for the Life Programmable Interface — SMILE methodology, digital twin knowledge base, case studies, and persona graph.

What this is

This is the reference implementation of LPI tools. The LPI-Platform intern stream uses this to understand SMILE logic before building the equivalent FastAPI endpoints in lpi-platform.

Architecture

src/
  index.ts              # MCP server entry — registers 14 tools
  types.ts              # TypeScript interfaces (SmilePhase, KnowledgeEntry, CaseStudy, etc.)
  tools/
    smile.ts            # SMILE methodology — overview, phase detail, topic listing
    knowledge.ts        # Knowledge base search — query by topic, get insights
    cases.ts            # Case studies — list, search, detail (free/paid tier)
    persona-graph.ts    # Neo4j persona graph — search, stats, relationship health
  store/
    knowledge-store.ts  # JSON data loader (smile-framework, knowledge-base, case-studies)
    anonymizer.ts       # PII anonymization for case studies
data/
    smile-framework.json    # SMILE phases, perspectives, AI journey, key concepts
    knowledge-base.json     # Digital twin knowledge entries
    case-studies.json       # Anonymized implementation case studies

For the LPI-Platform team

Your job: Study the tools in src/tools/ to understand the SMILE logic, then implement equivalent functionality as FastAPI endpoints in Python.

This repo (TypeScript, read-only MCP)	Your repo (Python, FastAPI REST API)
tools/smile.ts — SMILE phase logic	routers/goals.py — SMILE phase transitions on goals
store/knowledge-store.ts — JSON data	store.py — in-memory dict (Phase 3: Supabase)
types.ts — SmilePhase, KnowledgeEntry	models.py — Pydantic Goal, Signal, Recommendation
tools/cases.ts — free/paid tier logic	Future: tier-based access control on your API

Key things to study:

1. data/smile-framework.json — the SMILE phases, their order, activities, deliverables
2. tools/smile.ts — how phase transitions work (your smile.py validates these)
3. store/knowledge-store.ts — how data is loaded and queried (pattern for your store)

Run locally

npm install
npm run build
node dist/index.js    # starts MCP server on stdio

Requires Node.js 18+. Persona graph tools require NEO4J_PASSWORD env var.

Related repos

• lpi-platform — FastAPI implementation (intern stream)
• lpi-developer-kit — public sandbox with challenges