为 AI 编程助手提供持久化记忆和全文会话搜索功能，以 MCP 服务器形式提供。
AI 编程助手在不同会话之间会遗忘所有内容。架构决策、用户偏好、项目上下文、上周二调试的内容——全都消失了。你不得不不断地重复解释相同的事情。
Memory MCP 通过以下两种能力解决了这个问题：
显式记忆 -- 保存笔记、决策、模式和偏好，这些内容会在不同会话间持久存在。你的助手会记住你告诉过它的内容。
会话搜索 -- 对你整个对话历史进行全文搜索。无需滚动浏览日志，即可找到三周前讨论过的内容。
无需数据库服务器。无需后台进程。无需云端。只需你机器上的一个 SQLite 文件。
Related MCP server: MCP Vector Memory
来源 | 位置 | 格式 |
| JSONL (流式内容块) | |
Claude Code 历史记录 |
| JSONL (在会话文件清理后依然保留) |
| SQLite (sessions, messages, parts 表) | |
| JSONL (每行一个事件) |
添加新来源需要一个解析器文件和一个注册条目。请参阅 添加新会话来源。
需要 Python 3.11+ 以及 SQLite FTS5 支持（标准 Python 构建中已包含）。
pip install -e .或者直接使用 uv 运行（无需安装）：
uv run --directory /path/to/memory_mcp python -m memory_mcp添加到你的 MCP 客户端配置中（例如 ~/.claude/mcp.json 或项目级的 .mcp.json）：
使用 pip 安装：
{
"mcpServers": {
"memory": {
"command": "memory-mcp"
}
}
}使用 uv（无需安装）：
{
"mcpServers": {
"memory": {
"command": "uv",
"args": ["run", "--directory", "/path/to/memory_mcp", "python", "-m", "memory_mcp"]
}
}
}工具 | 描述 |
| 持久化保存带有可选标签和上下文的笔记。在所有未来的会话中均可访问。 |
| 对已保存的记忆进行全文搜索。基于关键词，按相关性排序。 |
| 浏览最近的记忆，可选择按标签过滤。 |
| 通过 ID 删除记忆。 |
工具 | 描述 |
| 浏览过去的会话。按来源 ( |
| 获取特定会话的完整对话内容。 |
| 对所有会话消息、思考块和工具使用记录进行全文搜索。 |
| 重新扫描会话目录并索引新增或更改的文件。 |
启动时，Memory MCP 会扫描配置的会话目录，并将每段对话索引到带有 FTS5 全文搜索索引的本地 SQLite 数据库中。后续启动时会跳过 mtime（修改时间）未更改的文件。
数据库位置： ~/.memory_mcp/memory.db (可通过 MEMORY_MCP_DB 环境变量覆盖)
会话来源： 从标准位置自动检测（可通过 MEMORY_MCP_SOURCES 环境变量扩展，格式：type:path;type:path）
索引： 按文件 mtime 增量进行，跨 8 个线程并行处理
搜索： 使用带有 BM25 排序、前缀匹配和短语支持的 FTS5
创建 memory_mcp/parsers/your_source.py 并实现 SessionParser 协议：
source_type: str 属性
parse_file(path: str) -> ParsedSession | None 方法
在 memory_mcp/parsers/__init__.py 中注册它
在 memory_mcp/config.py 中添加目录检测逻辑
示例请参考 parsers/claude_code.py 或 parsers/omp.py。
python tests/test_e2e.py端到端测试将 MCP 服务器作为子进程启动，通过 stdio 协议测试所有 8 个工具，并断言工具响应。使用临时数据库，因此不会触及你的真实数据。
memory_mcp/
server.py # FastMCP entry point, lifespan manages DB + startup scan
config.py # Auto-detects session dirs, DB path
db.py # SQLite + FTS5 schema, all queries, sync triggers
scanner.py # Walks session dirs, dispatches to parsers, parallel indexing
parsers/
base.py # ParsedSession / ParsedMessage dataclasses, SessionParser protocol
claude_code.py # Claude Code JSONL parser (merges streamed assistant blocks)
claude_history.py # Claude Code history.jsonl parser (one file, many sessions)
omp.py # OMP JSONL parser
opencode.py # OpenCode SQLite parser (reads DB directly, read-only)
tools/
memory.py # save_memory, search_memory, list_memories, delete_memory
sessions.py # list_sessions, get_session, search_sessions, refresh_sessionsMIT
Delete a specific memory by its ID.
| Name | Required | Description | Default |
|---|---|---|---|
| memory_id | Yes |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool deletes a memory, implying a destructive mutation, but doesn't cover critical aspects like whether deletion is permanent, requires specific permissions, has side effects (e.g., on related sessions), or returns confirmation data. For a destructive tool, this leaves significant gaps in understanding its behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, direct sentence with zero wasted words. It front-loads the key action ('Delete') and resource ('memory'), making it immediately scannable. Every word earns its place by contributing essential information without redundancy or fluff.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (destructive operation with 1 parameter) and lack of annotations, the description is minimally adequate. The presence of an output schema reduces the need to explain return values, but the description doesn't address behavioral risks or usage context. It covers the basic 'what' but misses the 'how' and 'when,' leaving room for improvement in safety and clarity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 0% description coverage, so the description must compensate. It adds meaning by specifying that 'memory_id' identifies 'a specific memory,' clarifying the parameter's role. However, it doesn't explain what a memory ID is (e.g., format, source) or constraints (e.g., valid ranges), leaving the schema's bare type ('integer') as the only guidance. This partial compensation earns a baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Delete') and target resource ('a specific memory by its ID'), making the purpose immediately understandable. It distinguishes from siblings like 'list_memories' and 'save_memory' by focusing on deletion rather than retrieval or creation. However, it doesn't specify what constitutes a 'memory' in this context, which slightly limits specificity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing an existing memory ID), exclusions, or comparisons to siblings like 'save_memory' for creation or 'list_memories' for retrieval. Without this context, users must infer usage from the tool name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Retrieve the conversation from a specific session. Shows the full message flow including user messages, assistant responses, and tool usage.
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | ||
| limit | No | ||
| offset | No |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It describes what the tool returns ('full message flow'), but doesn't disclose behavioral traits such as authentication needs, rate limits, error handling, or whether it's a read-only operation (though 'retrieve' implies reading). For a tool with no annotations, this leaves significant gaps in understanding its behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences that are front-loaded and efficient. The first sentence states the core purpose, and the second adds valuable detail about the content retrieved. There is no wasted language, and every sentence earns its place by enhancing clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has an output schema (which likely describes the return structure), the description doesn't need to explain return values. However, with no annotations, 3 parameters (one required), and 0% schema description coverage, the description is incomplete—it lacks parameter details and behavioral context. It's minimally adequate but has clear gaps for a retrieval tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the schema provides no descriptions for parameters. The description adds no information about parameters beyond what the schema names imply (e.g., session_id, limit, offset). It doesn't explain what a session_id is, how limit/offset affect pagination, or any constraints. With low coverage, the description fails to compensate, resulting in a baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'retrieve' and the resource 'conversation from a specific session', and specifies the content includes 'user messages, assistant responses, and tool usage'. It distinguishes from siblings like list_sessions or search_sessions by focusing on retrieving a specific session's content rather than listing or searching. However, it doesn't explicitly contrast with siblings like refresh_sessions, so it's not a perfect 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when to use get_session over list_sessions or search_sessions, nor does it specify prerequisites or exclusions. The context is implied by the action of retrieving a specific session, but no explicit usage rules are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
List recent saved memories, optionally filtered by tag.
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | ||
| limit | No |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions 'recent saved memories' but doesn't specify what 'recent' means (e.g., time frame, ordering), whether results are paginated, or any rate limits or permissions required. The description adds minimal context beyond the basic operation, leaving key behavioral traits undefined.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core purpose ('List recent saved memories') and adds an optional feature ('optionally filtered by tag') without unnecessary details. Every word earns its place, making it highly concise and well-structured for quick understanding.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's low complexity (2 optional parameters) and the presence of an output schema (which handles return values), the description is minimally adequate. However, with no annotations and 0% schema coverage, it lacks details on behavioral aspects like ordering, pagination, or error handling. It meets the baseline for a simple list tool but leaves gaps in usage and parameter context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate for undocumented parameters. It mentions optional filtering by 'tag' but doesn't explain tag semantics or format. It doesn't address the 'limit' parameter at all, leaving its purpose and constraints unclear. The description adds some meaning for 'tag' but fails to cover 'limit', resulting in incomplete parameter guidance.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('list') and resource ('recent saved memories') with an optional filtering capability ('by tag'). It distinguishes from siblings like 'search_memory' by focusing on listing rather than searching, though it doesn't explicitly contrast with 'get_session' or 'list_sessions'. The purpose is specific and actionable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for retrieving memories with optional tag filtering, but provides no explicit guidance on when to use this tool versus alternatives like 'search_memory' or 'list_sessions'. It mentions the filtering capability but doesn't clarify scenarios where listing is preferred over searching or other sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
List recent AI coding sessions. Filter by source ('claude_code' or 'omp') or by project path substring.
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | ||
| project | No | ||
| limit | No | ||
| offset | No |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions filtering capabilities but lacks details on permissions, rate limits, pagination behavior (beyond implied by limit/offset), or what 'recent' means. For a list tool with no annotation coverage, this leaves significant gaps in understanding how the tool behaves operationally.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core purpose and immediately details filtering options. Every word contributes directly to understanding the tool's functionality, with no wasted text or redundancy. It's appropriately sized for the tool's complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 4 parameters with 0% schema coverage and no annotations, the description partially compensates by explaining two parameters. An output schema exists, so return values need not be described. However, for a list tool with filtering and pagination, the description lacks completeness in behavioral aspects like default sorting, error handling, or full parameter coverage, making it adequate but with clear gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the schema provides no parameter descriptions. The description adds value by explaining that 'source' accepts 'claude_code' or 'omp' and 'project' filters by path substring, covering 2 of 4 parameters. However, it doesn't address 'limit' or 'offset', leaving half the parameters without semantic context. This partial compensation results in a baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('List') and resource ('recent AI coding sessions'), making the purpose specific and understandable. It distinguishes from siblings like 'get_session' (singular) and 'search_sessions' (broader search), though it doesn't explicitly name alternatives. The purpose is not vague or tautological.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for filtering by source or project path, suggesting when to use it for basic filtering. However, it doesn't provide explicit guidance on when to choose this tool over alternatives like 'search_sessions' or 'refresh_sessions', nor does it mention any exclusions or prerequisites. The guidance is limited to implied context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Scan for new or updated session files and index them. Run this if recent sessions aren't showing up in search results.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses the tool's purpose (scanning and indexing) and effect (making sessions searchable), but lacks details on permissions needed, rate limits, whether it's idempotent, or what 'indexing' entails technically. It adds some context but is incomplete for behavioral transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the core action and followed by usage guidance. Every word earns its place—no redundancy or fluff. Efficiently conveys purpose and when to use in minimal text.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 0 parameters, no annotations, and an output schema (which handles return values), the description is reasonably complete. It explains what the tool does and when to use it, but could improve by adding more behavioral context (e.g., side effects, time to index). The output schema reduces the need for return value details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are 0 parameters, and schema description coverage is 100% (empty schema). The description doesn't need to explain parameters, so it meets the baseline of 4 for tools with no parameters, as it can't add value beyond what the schema already provides (none).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('Scan for new or updated session files and index them') and resource ('session files'), distinguishing it from siblings like get_session (retrieve one), list_sessions (list existing), and search_sessions (search indexed sessions). It specifies the action of indexing, which siblings don't cover.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states when to use: 'Run this if recent sessions aren't showing up in search results.' This provides a clear trigger condition and implies an alternative (waiting for automatic indexing or using search_sessions without refresh). It differentiates from siblings by addressing indexing lag.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Save a note to persistent memory. Use this to remember important context, decisions, patterns, or user preferences across sessions.
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | ||
| tags | No | ||
| context | No |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses that the tool saves data persistently across sessions, which is a key behavioral trait. However, it lacks details on permissions, rate limits, error handling, or how the saved data is structured or retrieved, leaving gaps in behavioral understanding.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately sized and front-loaded, consisting of two concise sentences. The first sentence states the core purpose, and the second provides usage context, with no wasted words or redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (a write operation with 3 parameters), lack of annotations, and presence of an output schema, the description is moderately complete. It explains the tool's purpose and usage context but misses details on parameters, behavioral constraints, and how it interacts with sibling tools, making it adequate but with clear gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 0%, so the description must compensate. It does not mention any parameters explicitly, failing to add meaning beyond the input schema. The baseline is 3 because the schema covers all parameters (content, tags, context) with titles and types, but the description provides no additional semantic context for their use.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('save') and resource ('note to persistent memory'), distinguishing it from sibling tools like delete_memory, list_memories, and search_memory. It specifies that this is for writing data that persists across sessions, unlike get_session or list_sessions which are read-only.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context on when to use this tool ('to remember important context, decisions, patterns, or user preferences across sessions'), but does not explicitly state when not to use it or name alternatives. For example, it doesn't clarify whether to use save_memory versus other tools for similar purposes, though the context implies it's for persistent storage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Search saved memories. Use short keywords, not natural language phrases — each word is matched independently and ranked by relevance.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| tags | No | ||
| limit | No |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It adds useful context about search behavior ('each word is matched independently and ranked by relevance'), which goes beyond the basic purpose. However, it doesn't cover other important aspects like authentication needs, rate limits, error conditions, or what the output contains, leaving gaps for a tool with no annotation support.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is perfectly concise and well-structured in a single sentence that front-loads the purpose and follows with specific usage guidance. Every word serves a purpose with no wasted text, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that there's an output schema (which handles return values) but no annotations and 0% schema description coverage, the description provides adequate basic purpose and usage guidance but falls short on parameter explanations and behavioral details. For a search tool with 3 parameters, it should ideally provide more complete parameter semantics to compensate for the schema gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 0%, meaning none of the parameters have descriptions in the schema. The tool description mentions 'short keywords' which relates to the 'query' parameter, but doesn't explain the semantics of 'tags' or 'limit' parameters. This partial coverage doesn't adequately compensate for the complete lack of schema descriptions for a 3-parameter tool.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with the verb 'Search' and resource 'saved memories', making it immediately understandable. It distinguishes itself from siblings like 'list_memories' by specifying a search functionality, though it doesn't explicitly contrast with 'search_sessions' which might have similar search mechanics but different targets.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context on how to use the tool effectively ('Use short keywords, not natural language phrases'), which helps guide proper invocation. However, it lacks explicit guidance on when to choose this tool over alternatives like 'list_memories' or 'search_sessions', leaving some ambiguity in sibling differentiation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Search across all session messages. Use short keywords, not natural language phrases — each word is matched independently and ranked by relevance.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| limit | No | ||
| offset | No |
| Name | Required | Description |
|---|---|---|
| result | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It adds useful context about search behavior ('each word is matched independently and ranked by relevance'), but doesn't cover aspects like permissions, rate limits, or response format. This is adequate but has clear gaps for a search tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is highly concise and front-loaded: it starts with the core purpose, followed by specific usage advice. Every sentence adds value without redundancy, making it efficient and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's moderate complexity (search with pagination), no annotations, and an output schema (which handles return values), the description is partially complete. It covers search behavior but misses key details like pagination semantics and lacks sibling differentiation, leaving room for improvement.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate for undocumented parameters. It only mentions the 'query' parameter implicitly ('Use short keywords'), but doesn't explain 'limit' or 'offset' (pagination), nor does it clarify the query syntax or ranking details. This leaves significant gaps in parameter understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Search across all session messages.' It specifies the resource (session messages) and verb (search), but doesn't explicitly differentiate from sibling tools like 'search_memory' or 'list_sessions,' which would require a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides some guidance on how to use the tool effectively ('Use short keywords, not natural language phrases'), but doesn't specify when to choose this tool over alternatives like 'search_memory' or 'list_sessions.' It implies usage context without explicit exclusions or comparisons.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v0.1.0delete_memoryget_sessionlist_memorieslist_sessionsrefresh_sessionssave_memorysearch_memorysearch_sessionsScored across 8 tools
Each tool has a clearly distinct purpose with no overlap: delete_memory removes a memory, get_session retrieves a session's conversation, list_memories lists memories, list_sessions lists sessions, refresh_sessions indexes new sessions, save_memory stores a memory, search_memory searches memories, and search_sessions searches sessions. The descriptions reinforce these distinct roles, making misselection unlikely.
All tools follow a consistent verb_noun pattern using snake_case: delete_memory, get_session, list_memories, list_sessions, refresh_sessions, save_memory, search_memory, and search_sessions. This predictable naming scheme enhances readability and usability across the toolset.
With 8 tools, the server is well-scoped for managing memories and sessions. Each tool serves a clear purpose, such as CRUD operations for memories (save, list, search, delete) and sessions (list, get, search, refresh), avoiding bloat while covering essential functionality for the domain.
The toolset provides strong coverage for memory and session management, including create (save_memory), read (list_memories, get_session), delete (delete_memory), and search (search_memory, search_sessions). A minor gap exists in updating memories or sessions, but agents can work around this by deleting and re-saving, and the refresh_sessions tool handles session updates indirectly.
Persistent memory for AI agents. Search, store, and recall across sessions.
Persistent memory for AI agents. Search and store durable facts, preferences and decisions.
Shared memory for coding agents. Stop re-explaining your codebase every session.
Persistent memory for AI assistants: store, search, and connect knowledge across conversations.
