MCP server that exposes MASE (Multi-Agent System Evolution) long-term memory engine as tools for Claude Desktop, Cursor, and other MCP clients. Provides memory read/write, fact management, and complete ask pipeline execution.
MASE Memory MCP exposes 13 tools with mixed quality. Naming is generally verb-forward (get_, list_, mase_*), but descriptions vary widely: some are detailed (mase_remember, mase_upsert_fact), others are terse or Chinese-only (get_current_time: 'Returns the current system time'). Input schemas are present for all tools with proper type declarations, but parameter descriptions are inconsistent, some parameters lack descriptions entirely (e.g., 'dirpath' in list_directory has a description, but 'filepath' in read_local_file is minimal). Output schemas are not documented. Error handling is mentioned in read_local_file ('Returns a clearly-tagged error string') but absent from most other tools. No tool annotations (readOnlyHint, destructiveHint) are visible. The server mixes English and Chinese descriptions, which may confuse LLM parsing. Overall, tools are functional but lack the polish expected of production-grade agent tools.
Returns the current system time (ISO-ish, second precision).
List a directory inside the sandbox (one entry per line, dirs end in '/').
走 MASE 完整 pipeline (路由→记忆→规划→执行) 直接回答. (Execute the complete MASE pipeline (routing → memory → planning → execution) to directly answer a question.)
返回回答所依赖的证据链,而不是只给最终答案。(Return the evidence chain that supports an answer, not just the final answer.)
读取 MASE 当前事实表 (entity_state) 的全部(或某分类)结构化事实. 每条含 category / entity_key / entity_value, 适合作为"当前状态"高优先级、不依赖关键词召回地注入上下文,保证当前事实始终在场. (Read all or category-filtered structured facts from MASE current fact table.)
列出所有 thread (会话) 标识. (List all thread (conversation) identifiers.)
Output schemas not documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream field names and risk broken tool chains.
Bilingual descriptions (English + Chinese) may confuse LLM parsing. Descriptions like 'mase_remember' mix languages, reducing clarity for English-only LLMs.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) present. LLMs cannot determine which tools are safe to retry or have side effects.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
从 MASE 长期记忆按关键词 BM25 召回. (Recall from MASE long-term memory by keyword BM25 search.)
只召回当前事实表,适合 MCP 客户端询问"当前状态"。(Recall only from current fact table, suitable for querying current state.)
取某会话线程最近 limit 条事件, 按时序升序返回(最早在前). 适合"对话连续性"注入: 把最近几轮原样喂回模型, 回答"我第一句说了啥 / 刚才聊了啥 / 接着上文"这类按时间顺序的问题. thread 过滤在 SQL 内先于 LIMIT,取的是该线程最近 N 条, 而非全局最早 N 条里恰属于该线程的. (Get the most recent limit events from a conversation thread, returned in chronological ascending order.)
读取事件时间线,帮助客户端解释某条记忆来自哪段历史。(Read event timeline to help clients understand which historical period a memory comes from.)
把一条对话事件写入 MASE 长期记忆 (SQLite + FTS5),返回里带 log_id 便于溯源. (Write a conversation event to MASE long-term memory with log_id for traceability.)
把一条结构化事实写入 MASE 当前事实表 (entity_state). 同一个 (category, key) 再次写入不同 value 会触发 supersede:旧值被盖章进 entity_state_history, facts-first 召回只返回最新值. 适合"用户陈述的当前事实". (Write a structured fact to MASE current fact table; same (category, key) with different value triggers supersede.)
Read a UTF-8 text file from the configured MCP sandbox. Refuses to read when no sandbox is configured (MASE_MCP_SANDBOX). Returns a clearly-tagged error string instead of raising — the caller is an LLM tool-use loop and benefits from a consumable explanation rather than a stack trace.
mase_ask_tool description is vague ('Execute the complete MASE pipeline'). LLMs cannot determine when to use this vs. specific recall tools without clearer guidance.
Error handling guidance missing from most tools. Only read_local_file documents error behavior; others provide no recovery hints.