README.md•1.49 kB
# Breadcrumb MCP Server
MCP (Model Context Protocol) server for the Breadcrumbs project memory system.
## Installation
```bash
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:
```json
{
"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
```bash
# Install with dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Format code
black src/
# Lint
ruff check src/
```