Documentation
¶
Overview ¶
Package mcp implements the Model Context Protocol server for Engram.
This exposes memory tools via MCP stdio transport so ANY agent (OpenCode, Claude Code, Cursor, Windsurf, etc.) can use Engram's persistent memory just by adding it as an MCP server.
Tool profiles allow agents to load only the tools they need:
engram mcp → all 15 tools (default) engram mcp --tools=agent → 11 tools agents actually use (per skill files) engram mcp --tools=admin → 4 tools for TUI/CLI (delete, stats, timeline, merge) engram mcp --tools=agent,admin → combine profiles engram mcp --tools=mem_save,mem_search → individual tool names
Index ¶
- Variables
- func NewServer(s *store.Store) *server.MCPServer
- func NewServerWithConfig(s *store.Store, cfg MCPConfig, allowlist map[string]bool) *server.MCPServer
- func NewServerWithTools(s *store.Store, allowlist map[string]bool) *server.MCPServer
- func ResolveTools(input string) map[string]bool
- type MCPConfig
Constants ¶
This section is empty.
Variables ¶
var ProfileAdmin = map[string]bool{ "mem_delete": true, "mem_stats": true, "mem_timeline": true, "mem_merge_projects": true, }
ProfileAdmin contains tools for TUI, dashboards, and manual curation that are NOT referenced in any agent skill or memory protocol.
var ProfileAgent = map[string]bool{ "mem_save": true, "mem_search": true, "mem_context": true, "mem_session_summary": true, "mem_session_start": true, "mem_session_end": true, "mem_get_observation": true, "mem_suggest_topic_key": true, "mem_capture_passive": true, "mem_save_prompt": true, "mem_update": true, }
ProfileAgent contains the tool names that AI agents need. Sourced from actual skill files and memory protocol instructions across all 4 supported agents (Claude Code, OpenCode, Gemini CLI, Codex).
var Profiles = map[string]map[string]bool{ "agent": ProfileAgent, "admin": ProfileAdmin, }
Profiles maps profile names to their tool sets.
Functions ¶
func NewServerWithConfig ¶ added in v1.11.0
func NewServerWithConfig(s *store.Store, cfg MCPConfig, allowlist map[string]bool) *server.MCPServer
NewServerWithConfig creates an MCP server with full configuration including default project detection and optional tool allowlist.
func NewServerWithTools ¶
NewServerWithTools creates an MCP server registering only the tools in the allowlist. If allowlist is nil, all tools are registered.
func ResolveTools ¶
ResolveTools takes a comma-separated string of profile names and/or individual tool names and returns the set of tool names to register. An empty input means "all" — every tool is registered.
Source Files