Lore Framework MCP (Python)

MCP server for Lore Framework - AI-readable project memory with task/ADR/wiki management.

Important: This MCP server is just one component of Lore Framework. For the complete experience (skills, hooks, agents), install the full plugin: lore-framework plugin

Installation

# Using uvx (recommended)
uvx lore-framework-mcp

# Using pip
pip install lore-framework-mcp

Usage

As MCP Server

Add to your .mcp.json:

{
  "mcpServers": {
    "lore-framework": {
      "command": "uvx",
      "args": ["lore-framework-mcp"]
    }
  }
}

As CLI

# Set current user
lore-framework-mcp set-user <user_id>
lore-framework-mcp set-user --env  # from LORE_SESSION_CURRENT_USER

# Set current task
lore-framework-mcp set-task <task_id>

# Show session state
lore-framework-mcp show-session

# List available users
lore-framework-mcp list-users

# Clear current task
lore-framework-mcp clear-task

# Regenerate indexes
lore-framework-mcp generate-index
lore-framework-mcp generate-index --next-only --quiet

MCP Tools

Why Lore?

LLMs need "why", not just "what".

Without history, LLMs treat existing code patterns as gospel—replicating legacy hacks, undocumented workarounds, and accidental complexity. Lore provides AI-readable project memory: tasks capture requirements, worklogs show reasoning, ADRs explain decisions.

Read more: Full motivation

Lore Directory Structure

lore/
├── 0-session/           # Session state (gitignored)
│   ├── team.yaml        # Team members definition
│   ├── current-user.md  # Active user (generated)
│   ├── current-task.md  # Symlink to active task
│   └── next-tasks.md    # Auto-generated task queue
├── 1-tasks/             # Task management
│   ├── active/          # In-progress tasks
│   ├── blocked/         # Blocked tasks
│   ├── backlog/         # Planned tasks
│   └── archive/         # Completed tasks
├── 2-adrs/              # Architecture Decision Records
├── 3-wiki/              # Project documentation
└── README.md            # Auto-generated index

Documentation

See full documentation: Lore Framework Plugin

Author

License

MIT