lore-framework-mcp 1.2.10
MCP server for Lore Framework - AI-readable project memory with task/ADR/wiki management
Requires Python: >=3.10
Keywords: adr, ai-memory, claude, claude-code, lore, mcp, project-management, task-tracking

# 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](https://github.com/maledorak/maledorak-marketplace/tree/main/plugins/lore-framework)

## Installation

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

# Using pip
pip install lore-framework-mcp
```

## Usage

### As MCP Server

Add to your `.mcp.json`:

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

### As CLI

```bash
# 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

| Tool | Description |
|------|-------------|
| `lore_framework_set_user` | Set current user from team.yaml |
| `lore_framework_set_task` | Set current task by ID (creates symlink) |
| `lore_framework_show_session` | Show current session state (user and task) |
| `lore_framework_list_users` | List available users from team.yaml |
| `lore_framework_clear_task` | Clear current task symlink |
| `lore_framework_generate_index` | Regenerate lore/README.md and next-tasks.md |

## 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](https://github.com/maledorak/maledorak-marketplace/tree/main/plugins/lore-framework#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](https://github.com/maledorak/maledorak-marketplace/tree/main/plugins/lore-framework)

## Author

<div>
    <a href="https://twitter.com/maledorak">
        <img src="https://img.shields.io/badge/X/Twitter-000000?style=for-the-badge&logo=x&logoColor=black&color=white" />
    </a>
    <a href="https://www.linkedin.com/in/mariuszkorzekwa/">
        <img src="https://img.shields.io/badge/LinkedIn-000000?style=for-the-badge&logo=linkedin&logoColor=black&color=white" />
    </a>
    <a href="https://github.com/maledorak">
        <img src="https://img.shields.io/badge/GitHub-000000?style=for-the-badge&logo=github&logoColor=black&color=white" />
    </a>
</div>

## License

MIT