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/

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI assistants to interact with the Breadcrumbs project memory system, allowing creation and management of project documentation including sessions, components, ADRs, patterns, and providing search capabilities across project knowledge.

Breadcrumb MCP Server

Breadcrumb MCP Server

Installation

Usage

Configuration

Features

Tools

Resources

Development

New MCP Servers

MCP directory API