Skip to content

Commit 16db655

Browse files
committed
Add MCP server — AI agent integration with immutable context ledger
File protection tools: status, log, snapshot, verify, restore, tag, diff, search Context ledger tools: save, restore, log, diff, branch, verify 14 tools total. Context snapshots are content-addressed, chain-linked, and integrity-verified — immutable working state for AI agents.
1 parent 8d3fdb6 commit 16db655

3 files changed

Lines changed: 665 additions & 0 deletions

File tree

README.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -347,6 +347,57 @@ The EU AI Act (2026) mandates audit trails and version control for high-risk AI
347347
cargo test # 42 tests — hashing, deltas, storage, manifests, sessions, engine, gating, e2e
348348
```
349349

350+
## MCP Server — AI Agent Integration
351+
352+
Amber includes an MCP (Model Context Protocol) server that gives AI assistants direct access to checkpoint protection and context management. The tool built because an AI destroyed model weights — now integrated into AI assistants so they protect checkpoints instead of destroying them.
353+
354+
### Setup
355+
356+
```bash
357+
pip install "mcp[cli]"
358+
```
359+
360+
Add to your Claude Code settings (`.claude/settings.json`):
361+
362+
```json
363+
{
364+
"mcpServers": {
365+
"amber": {
366+
"command": "python3",
367+
"args": ["/path/to/Amber/amber-mcp/amber_mcp.py"]
368+
}
369+
}
370+
}
371+
```
372+
373+
### File Protection Tools
374+
375+
| Tool | Description |
376+
|---|---|
377+
| `amber_status` | Show watched paths and protection status |
378+
| `amber_log` | View version history before modifying files |
379+
| `amber_snapshot` | Force a snapshot before making risky changes |
380+
| `amber_verify` | Verify integrity of stored checkpoints |
381+
| `amber_restore` | Restore a file to a previous version |
382+
| `amber_tag` | Tag versions with scores, phase, metadata |
383+
| `amber_diff` | Compare two versions |
384+
| `amber_search` | Search content across version history |
385+
386+
### Context Ledger Tools
387+
388+
Immutable, content-addressed snapshots of AI working context — every context state is hashed, chain-linked, and verifiable.
389+
390+
| Tool | Description |
391+
|---|---|
392+
| `context_save` | Snapshot current working state (files, decisions, findings, constraints) |
393+
| `context_restore` | Restore a previous context state with integrity verification |
394+
| `context_log` | View context version history |
395+
| `context_diff` | See what changed between context snapshots |
396+
| `context_branch` | Branch context for exploring different approaches |
397+
| `context_verify` | Verify integrity of all stored context snapshots |
398+
399+
---
400+
350401
## Contributing
351402

352403
Issues, bug reports, and pull requests are welcome. If you're using Amber in your training pipeline, I'd like to hear about it — open an issue or start a discussion.

0 commit comments

Comments
 (0)