@rbrtdds/acp-mcp
v0.1.5
Published
AI Context Protocol — MCP server for Claude Code integration
Maintainers
Readme
@rbrtdds/acp-mcp
MCP server for ACP (AI Context Protocol) — gives Claude Code persistent memory across sessions.
Install & Setup
npm i -g @rbrtdds/acp-cli @rbrtdds/acp-mcp
acp initRequires Node.js >= 18.
acp init handles everything — config, MCP registration with Claude Code, and CLAUDE.md setup. No manual steps needed.
If you need to register the MCP server manually (e.g. claude CLI not in PATH during init):
claude mcp add --transport stdio --scope user acp -- acp-mcpTools
The MCP server exposes these tools to Claude:
acp_context
Get proactive context for current project. Call at the start of every session.
- Returns relevant facts and project history
- No parameters required
acp_recall
Search memory for relevant context from previous sessions.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| query | string | — | What to search for (e.g., "auth middleware") |
| scope | "project" | "all" | "project" | Search current project or all projects |
| max_results | number | 10 | Maximum facts to return |
acp_remember
Save important facts, decisions, or learnings to persistent memory.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| content | string | — | The fact to remember |
| type | string | — | Category: stack, decision, architecture, convention, blocker, task, learning, preference, contact, custom |
| confidence | number | 0.9 | Confidence score (0-1) |
| pinned | boolean | false | Pin to prevent compaction |
acp_status
Show memory stats — facts count, sessions, storage size. No parameters.
acp_facts
List all stored facts for current project.
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| type | string | — | Filter by fact type (optional) |
| limit | number | 50 | Maximum facts to return |
How it works
Claude Code ←→ MCP protocol ←→ acp-mcp ←→ SQLite (~/.acp/acp.db)The server runs as a stdio MCP process. Claude Code launches it automatically when configured. Project context is scoped by the working directory — ACP won't leak context from other projects.
Related
@rbrtdds/acp-cli— CLI tool for managing ACP@rbrtdds/acp-core— Core library@rbrtdds/acp-embeddings— Local embedding provider
License
MIT
