Breadcrumb MCP Server

MCP (Model Context Protocol) server for the Breadcrumbs project memory system.

Installation

cd mcp-server
pip install -e .

Usage

The server will be automatically discovered by Claude Code when configured in your MCP settings.

Configuration

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "breadcrumb": {
      "command": "python3",
      "args": ["-m", "breadcrumb_mcp.server"],
      "env": {
        "BREADCRUMB_ROOT": "/path/to/breadcrumb"
      }
    }
  }
}

Features

Tools

• Project Management: create_project, list_projects, get_project_info, get_project_stats
• Documentation: create_session, create_component, create_adr, create_pattern
• Search: search_breadcrumbs, find_related_docs, list_tags, get_timeline
• Updates: add_learning, add_followup, update_project_status, quick_note
• Indexing: generate_master_index, get_quick_reference

Resources

• breadcrumb://projects - List all projects
• breadcrumb://project/{name}/index - Read project index
• breadcrumb://project/{name}/sessions/{file} - Read session log
• breadcrumb://project/{name}/components/{file} - Read component doc
• breadcrumb://project/{name}/adr/{file} - Read ADR
• breadcrumb://project/{name}/patterns/{file} - Read pattern

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/

# Lint
ruff check src/