Piia Engram · MCP Server

Beschreibung des Anbieters

Local-first AI identity for MCP coding tools. Lessons, decisions, and context you control.

Werkzeuge

get_user_context

获取用户的个性化上下文（冷启动，分层延迟可控）。 / Get tiered cold-start user context with latency control. **Lifecycle: startup** — 对话开始时调用，为 AI 注入用户身份和上下文。… Angabe des Anbieters · Beleg 5

refresh_quick_context

刷新本地 `quick_context.md` 快照（跨工具 / 离线场景的快速通路）。 / Refresh the local quick_context.md snapshot (cross-tool / offline fast path).… Angabe des Anbieters · Beleg 5

get_identity_card

导出用户的可携带 AI 身份卡（Markdown 格式）。 / Export the user's portable AI identity card as Markdown.… Angabe des Anbieters · Beleg 5

get_identity_facets

按切面读取用户身份信息（画像/偏好/信任边界/工作风格/质量标准/领域图谱）。 / Read user identity facets: profile, preferences, trust boundaries, work style, quality standards, and the domain map.… Angabe des Anbieters · Beleg 5

get_lessons

获取用户从过去项目中学到的经验教训。 / Get lessons the user learned from past projects. 用途：用这些经验来避免重复过去的错误，可按领域、来源工具和数量过滤。… Angabe des Anbieters · Beleg 5

get_decisions

按时间列出关键决策；也可还原决策链或某个问题的修订历史。 / List the user's key decisions by time; can also reconstruct a decision thread or a question's revision history.… Angabe des Anbieters · Beleg 5

get_project_context

读取特定项目的知识快照（项目级，只含该项目的历史）。 / Read the knowledge snapshot for a specific project, containing only that project's history. 用途：想了解某个项目之前的技术栈、已知问题、协作次数时调用。… Angabe des Anbieters · Beleg 5

list_projects

列出用户参与过的所有项目及基本信息。 / List all projects the user has worked on with basic metadata. 用途：需要发现已有项目记录、确认项目路径或查看项目清单时调用。… Angabe des Anbieters · Beleg 5

get_relevant_knowledge

按项目路径自动推荐最相关的经验教训（无需搜索词）。 / Automatically recommend the most relevant lessons for a project path, without search keywords. **Lifecycle: retrieval** — 在对话中需要项目相关的历史知识时调用。… Angabe des Anbieters · Beleg 5

get_knowledge_inheritance

为新项目或任务生成可继承知识包。 / Build a knowledge inheritance pack for a new project or task. 用途：根据自由文本描述，从现有 lessons 和 decisions 中找出最相关的可复用知识。… Angabe des Anbieters · Beleg 5

search_knowledge

搜索知识库（lessons/decisions/playbooks）。 / Search lessons, decisions, and playbooks by keyword. **Lifecycle: retrieval** — 在对话中需要检索历史知识时调用。… Angabe des Anbieters · Beleg 5

get_knowledge_overview

获取统一的知识概览：摘要、健康报告和过期知识。 / Get a unified knowledge overview: digest, health report, and stale items. 用途：需要快速了解知识库整体状态、健康度或待复查条目时调用。… Angabe des Anbieters · Beleg 5

explore_knowledge

探索知识关联：相连条目、相似条目或全库合并建议。 / Explore knowledge links: related items, similar items, or merge candidates across the library.… Angabe des Anbieters · Beleg 5

export_knowledge_report

导出完整 Markdown 知识报告并返回内容。 / Export a full Markdown knowledge report and return its content.… Angabe des Anbieters · Beleg 5

get_permission_profile

查看当前所有调用者的权限全景：谁有什么信任级别、能看到什么。 / View the permission landscape: who has what trust level and what they can access. 用途：想了解"哪些 AI 工具可以读我的 Engram"、"Cursor 能看到私密数据吗"时调用。… Angabe des Anbieters · Beleg 6

manage_caller_trust

调用者信任统一入口：授予 / 修改 / 撤销某个 AI 工具的信任级别。 / Unified caller-trust management: grant, change, or revoke an AI tool's trust level.… Angabe des Anbieters · Beleg 6

update_identity

更新一个身份字段。 / Update one identity field. 用途：需要修改 profile、preferences、trust_boundaries、work_style 或 quality_standards 时调用。… Angabe des Anbieters · Beleg 6

save_project_snapshot

写入或更新项目的知识快照（写操作，不是读取）。 / Write or update a project's knowledge snapshot; this is a write operation, not a read. 用途：保存或更新当前项目的技术栈、已知问题、注释等信息。… Angabe des Anbieters · Beleg 6

user_portrait

用户写照统一入口：查看 / 对比 / 保存快照。 / Unified user portrait: view, compare, or snapshot.… Angabe des Anbieters · Beleg 6

read_web_content

读取网页、视频或文章的文本内容。 / Read text content from a web page, video, or article. 用途：用户发链接并要求分析、看看或读一下时调用。 Purpose: Call when the user sends a URL and asks to analyze, inspect, or read it.… Angabe des Anbieters · Beleg 6

export_engram

导出 Engram 数据：单文件备份或 OpenClaw 兼容格式。 / Export Engram data: a single-file backup, or the OpenClaw-compatible format.… Angabe des Anbieters · Beleg 6

import_engram

导入 Engram 数据：从备份文件或 OpenClaw 兼容文件。 / Import Engram data: from a backup file, or from OpenClaw-compatible files.… Angabe des Anbieters · Beleg 6

get_audit_log

获取最近的审计日志条目。 / Get recent audit log entries. 用途：需要查看 Engram 最近的读写操作、排查行为或核对记录时调用。 Purpose: Call when inspecting recent Engram reads/writes, debugging behavior, or auditing activity.… Angabe des Anbieters · Beleg 6

wrap_up_session

会话结束一键收尾：自动提取知识、操作流程并保存项目快照。 / Wrap up a session in one step: extract knowledge, detect playbooks, and save a project snapshot. **Lifecycle: session-end** — 对话结束时调用，完成知识提取和上下文保存。… Angabe des Anbieters · Beleg 6

get_wrap_up_session_status

读取 wrap_up_session 的阶段状态。 / Read metadata-only stage status for a wrap_up_session operation. 用途：当 MCP 客户端在会话收尾时遇到 transport timeout，可用调用前已知的 idempotency_key，或成功返回过的 operation_id，查询最后阶段和终态。… Angabe des Anbieters · Beleg 6

export_feedback_report

导出匿名内测反馈报告。 / Export anonymous beta feedback report. 用途：用户想分享使用反馈时调用。报告只包含计数和分布，不含知识内容或个人信息。 Purpose: Call when the user wants to share usage feedback.… Angabe des Anbieters · Beleg 6

doctor

记忆系统自诊断。 / Memory system self-diagnosis. 用途：检查 Engram 记忆系统健康状态，发现潜在问题（数据碎片、过期知识、冲突决策、 身份层异常等）。这是 MCP doctor；CLI 冲突视图请用 ``engram conflicts list``。… Angabe des Anbieters · Beleg 6

start_project

新项目一键启动：继承跨项目经验并建立项目档案。 / Start a new project in one step: inherit cross-project knowledge and create a project record. 用途：开始一个新项目时调用，一次拿到过往相关 lessons 和 decisions，并初始化项目快照。… Angabe des Anbieters · Beleg 6

memory_store

统一知识写入入口 — 根据 kind 自动路由到 add_lesson / add_decision / add_playbook。 Unified knowledge write endpoint — routes to add_lesson / add_decision / add_playbook based on kind.… Angabe des Anbieters · Beleg 7

add_lesson

记录单条经验教训（你已经知道要记什么）。 / Record one lesson learned when you already know what to save. **Lifecycle: writeback** — 对话中学到可复用的经验时调用。… Angabe des Anbieters · Beleg 7

Voraussetzungen

• uvx · Paketmanager · erforderlich · Beleg 1
• ENGRAM_MCP_STARTUP_SYNC · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 1
• ENGRAM_TOOLS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 1
• PYTHONIOENCODING · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 1
• MCP_PUBLISHER_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 8
• MCP_PUBLISHER_BIN · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 8
• ENGRAM_HEARTBEAT_INTERVAL · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 9
• ENGRAM_AUTH_TOKEN · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 9
• ENGRAM_CORS_ORIGINS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 9
• ENGRAM_EMBED_MODEL · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 10
• FASTEMBED_CACHE_PATH · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 10
• ENGRAM_SECRET · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 11
• ENGRAM_AUDIT · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 11
• ENGRAM_GOVERNANCE · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 11
• ENGRAM_CLIENT_TYPE · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 11

Installation

uvx piia-engram==4.21.2 --from piia-engram==4.21.2 piia-engram-mcp --transport stdio

Angaben zum Baustein

—: Angabe nicht belegt.

Maintainer

Patdolitse

Repository-Lizenz

AGPL-3.0-only

Letzter Repository-Commit

2026-09-26

Commit innerhalb 90 Tagen

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

—

Bereiche

Entwicklung

Plattformen

—

Version

4.21.2

Release

v4.21.2

Clients

Claude Code, Claude Desktop, ChatGPT, Cursor, Codex, Windsurf, Cline, Gemini, Roo Code, Zed, OpenClaw

Repository-Themen

ai-agent, claude-code, codex, context-management, cursor, local-first, mcp, model-context-protocol, ai-identity, anthropic

Homepage

Homepage des Anbieters

Dokumentation

Dokumentation des Anbieters

Zugriffe und Risiken

Regelbasiert abgeleitete Zugriffe

lesen, schreiben

Authentifizierung

—

Transport

stdio

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe. Vor dem Einsatz Konten, Dateien, Netzwerkverbindungen und Ausführungsrechte im konkreten Paket prüfen. Eine frische Änderung am Repository belegt keine Wartung jeder einzelnen Datei.

Nur die für den Arbeitsablauf nötigen Berechtigungen vergeben und Schreibaktionen mit einem Freigabeschritt absichern. Lizenz und Wartungsdatum sind keine Sicherheitsfreigabe.

Der Lizenzbeleg betrifft das Quellcode-Repository. Einzelne Unterpakete und gehostete Dienste können eigene Bedingungen haben; prüfe sie beim konkreten Installations- oder Diensteangebot.