Claude Conversation Memory MCP

MCP搜索检索

提供方 xiaolai

搜索检索 未标注 API Key 社区 / 第三方 Claude DesktopClaude

CCCMemory MCP是一个为Claude提供长期记忆功能的服务器,通过语义搜索、决策跟踪和跨项目搜索索引对话历史。

一句话选型结论

按资料字段整理

Claude Conversation Memory MCP 属于搜索检索类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类搜索检索 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 26 仓库热度,无公开仓库时显示未标注
工具数 19 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

搜索检索
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量19暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

语义搜索TypeScript本地部署对话管理决策跟踪跨项目搜索工作记忆

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 19 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
联网搜索取证

让模型查最新资料并给出出处。

资料聚合

把一个主题的网页、文档集中抓回来整理。

情报与竞品检索

按关键词持续检索行业动态和竞品信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 19 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在搜索检索场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Claude Conversation Memory MCP当前 19 未标注 未标注 无 2026-05-17
Brave Search 433812ff 2 未标注 未标注 无 2026-05-17
Sequentialthinking 1 SSE · 服务端推送 远程部署 有 2026-05-18
Baidu Netdisk 未标注 未标注 未标注 无 2026-05-17
ragflow 未标注 stdio · 本地进程 本地部署 有 2026-04-11
mindsdb (430e18) 未标注 未标注 未标注 有 2026-05-17

服务器档案

搜索检索
字段来自项目仓库与公开索引,中文说明由本站标注
提供方xiaolai上游标注的维护方 xiaolai
分类搜索检索本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.8 KB
来自项目仓库与上游目录的原文,未做删改

CCCMemory MCP

一个MCP服务器,通过语义搜索、决策跟踪和跨项目搜索对对话历史进行索引,为克劳德提供长期记忆。


v2.0中的新增功能

2.0版本对搜索质量和准确性进行了重大改进:

  • 智能分块 -长消息现在在句子边界处拆分,确保完整内容可搜索(以前截断为512个标记)
  • 混合搜索 -使用互惠排名融合(RRF)将语义搜索与全文搜索相结合,以获得更好的排名
  • 动态阈值 -相似性阈值根据查询长度进行调整,以提高精度
  • 改进的片段 -搜索结果突出显示上下文中的匹配词
  • 提取验证 -减少决策/错误检测中的误报
  • 查询扩展 -可选同义词扩展以实现更广泛的召回(默认情况下禁用)

⚠️ Breaking Changes in v1.8.0 (click to expand)

此包已从重命名 claude-conversation-memory-mcp 到 cccmemory.

如果从旧软件包升级:

  1. 卸载旧软件包: npm uninstall -g claude-conversation-memory-mcp
  2. 安装新软件包: npm install -g cccmemory
  3. 更新MCP配置以使用 cccmemory 命令
  4. 数据库迁移是自动的(.claude-conversations-memory.db → .cccmemory.db)

特性

  • 搜索对话 -在聊天记录中搜索自然语言
  • 智能分块 -长消息完全索引,没有截断
  • 混合搜索 -将矢量+关键字搜索与RRF重新排名相结合
  • 跟踪决策 -记住你为什么做出技术选择
  • 防止错误 -从过去的错误中吸取教训
  • Git集成 -将对话链接到提交
  • 跨项目搜索 -在全球范围内搜索您的所有项目
  • 项目迁移 -重命名/移动项目时保留历史记录
  • 语义搜索 -使用Transformers.js嵌入(捆绑,离线工作)
  • 工作记忆 -跨会话存储和回忆事实、决策和上下文
  • 会话切换 -对话之间无缝的上下文转换
  • 标签管理 -使用标签组织记忆、决策和模式
  • 内存质量 -跟踪信心、重要性和验证状态
  • 数据库维护 -查找重复项、清理过时数据、运行状况报告

安装

Node.js版本

CCCMemory支持 Node.js 20或22 LTS.使用其他版本可能会破坏本机
模块(如 better-sqlite3).如果切换节点版本,请重新安装
包(或运行 npm rebuild better-sqlite3 在本地克隆中)。```bash
npm install -g cccmemory


验证安装:```bash
cccmemory --version

配置

适用于克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):```json
{
"mcpServers": {
"cccmemory": {
"command": "npx",
"args": ["-y", "cccmemory"]
}
}
}


然后重新启动Claude Desktop。

### 克劳德代码

编辑 `~/.claude.json` (注意:此文件位于您的主目录中,而不是内部 `~/.claude/`):```json
{
"mcpServers": {
"cccmemory": {
"command": "npx",
"args": ["-y", "cccmemory"]
}
}
}

或者,如果全局安装:```json
{
"mcpServers": {
"cccmemory": {
"command": "cccmemory"
}
}
}


### 用于Codex CLI

Codex将MCP设置存储在 `~/.codex/config.toml` (由CLI和IDE扩展共享)。

**推荐(CLI):**```bash
codex mcp add cccmemory -- npx -y cccmemory

手动配置(~/.codex/config.toml):```toml
[mcp_servers.cccmemory]
command = "npx"
args = ["-y", "cccmemory"]


如果全局安装,则可以使用:```toml
[mcp_servers.cccmemory]
command = "cccmemory"

打开Codex并运行 /mcp 在TUI中验证服务器是否处于活动状态。

存储路径

默认情况下,CCCMemory使用 单个数据库:

  • ~/.cccmemory.db

如果要按项目隔离,请设置:```bash
export CCCMEMORY_DB_MODE="per-project"


在每个项目模式下,CCCMemory存储:

- `~/.claude/projects//.cccmemory.db`
- 回退(受限沙盒): `/.cccmemory/.cccmemory.db`

如果您的主目录不可写(在沙盒Codex/Claude设置中很常见
`~/.claude` 和 `~/.codex` 被锁定),设置显式可写路径:```bash
export CCCMEMORY_DB_PATH="/path/to/cccmemory.db"

对于MCP配置,请在服务器定义中添加这些环境变量。CCCMemory存储
全球项目注册表 在同一数据库内 (项目+项目资源表)。

嵌入配置(可选)

MCP使用 Transformers.js 默认情况下用于语义搜索(捆绑,脱机工作,无需设置)。

模型下载和缓存行为(Transformers.js):\
在第一次使用时, @xenova/transformers 下载模型权重并将其缓存在自己的默认缓存目录中。CCCMemory不管理或重新定位该缓存。后续运行重用缓存的模型并完全脱机工作。

要自定义,请创建 ~/.claude-memory-config.json:```json
{
"embedding": {
"provider": "transformers",
"model": "Xenova/all-MiniLM-L6-v2",
"dimensions": 384
}
}


**替代供应商:**

Ollama (faster, requires Ollama running)```bash
# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh
ollama pull mxbai-embed-large
ollama serve

配置:```json
{
"embedding": {
"provider": "ollama",
"model": "mxbai-embed-large",
"dimensions": 1024
}
}


OpenAI (requires API key)```json
{
"embedding": {
"provider": "openai",
"model": "text-embedding-3-small",
"dimensions": 1536
}
}

集 OPENAI_API_KEY 环境变量。

搜索配置(可选)

使用环境变量调整搜索行为:

变量 默认值 描述
CCCMEMORY_CHUNKING_ENABLED true 为长消息启用智能分块
CCCMEMORY_CHUNK_SIZE 450 目标块大小(以令牌为单位)
CCCMEMORY_CHUNK_OVERLAP 0.1 块之间的重叠(0-1)
CCCMEMORY_RERANK_ENABLED true 启用混合重新排序(向量+FTS)
CCCMEMORY_RERANK_WEIGHT 0.7 重新排序中的向量权重(FTS得到1个权重)
CCCMEMORY_QUERY_EXPANSION false 为查询启用同义词扩展

MCP工具

索引

工具 说明
index_conversations 索引当前项目的对话
index_all_projects 索引所有Claude Code+Codex项目

搜索

工具 说明
search_conversations 在当前项目中搜索邮件
search_project_conversations 在Claude Code+Codex中搜索项目
search_all_conversations 在所有索引项目中搜索
get_decisions 查找架构决策
get_all_decisions 所有项目的决策
search_mistakes 查找过去的错误和修复
search_all_mistakes 所有项目中的错误
find_similar_sessions 查找相关对话

上下文

工具 说明
check_before_modify 编辑文件前获取上下文
get_file_evolution 查看提交的文件历史记录
search_by_file 查找与文件相关的所有上下文
list_recent_sessions 列出最近的会议及其摘要
get_latest_session_summary 总结最新会话(问题、操作、错误)
recall_and_apply 回忆当前任务的过去工作
get_requirements 查找组件要求
get_tool_history 查询工具使用历史
link_commits_to_conversations 将git提交连接到会话

项目管理

工具 说明
discover_old_conversations 从重命名的项目中查找文件夹
migrate_project 迁移/合并对话历史记录
forget_by_topic 按关键字删除对话
generate_documentation 从本地代码扫描+对话生成文档

工作记忆

工具 说明
remember 使用可选TTL存储事实、决策或上下文
recall 按键检索特定内存
recall_relevant 跨存储记忆的语义搜索
list_memory 列出所有记忆,可选择按标签筛选
forget 按键删除内存

会话切换

工具 说明
prepare_handoff 为会话转换创建切换文档
resume_from_handoff 从之前的移交中恢复工作
list_handoffs 列出可用的移交文件

上下文注入

工具 说明
get_startup_context 在对话开始时获取相关上下文
inject_relevant_context 基于用户消息自动注入上下文

标签管理

工具 说明
list_tags 列出所有带有使用统计信息的标签
search_by_tags 按标签查找项目(记忆、决策、模式)
rename_tag 重命名所有项目的标签
merge_tags 将多个标签合并为一个
delete_tag 删除标记并取消链接所有项目
tag_item 为项目添加标签
untag_item 从项目中删除标签

内存质量

工具 说明
set_memory_confidence 设定置信水平(不确定/可能/已确认/已验证)
set_memory_importance 设置重要性级别(低/正常/高/关键)
pin_memory 固定内存以防止清理
archive_memory 使用可选原因存档内存
unarchive_memory 恢复已存档的内存
search_memory_by_quality 按信心/重要性搜索记忆
get_memory_stats 按置信度/重要性获取内存统计数据

维护

工具 说明
get_storage_stats 数据库大小和项目计数
find_stale_items 查找最近未访问的项目
find_duplicates 查找相似/重复项目
merge_duplicates 合并重复项目
cleanup_stale 存档或删除过时的项目
vacuum_database 回收磁盘空间
cleanup_orphans 删除孤立记录
get_health_report 整体数据库健康检查
run_maintenance 运行多个维护任务
get_maintenance_history 查看过去的维护操作

会话ID

list_recent_sessions 回报 两个标识符:

  • id:内部对话id(用于 scope="current" 过滤器、切换和文档过滤器)
  • session_id:外部会话id(Claude JSONL文件名/Codex卷展id)。用于 index_conversations 和CLI index --session.

index_conversations 要么接受,要么接受外部 session_id 是首选。

CLI使用情况

该软件包包括一个独立的CLI:```bash

Interactive mode

cccmemory

Single commands

cccmemory status
cccmemory index
cccmemory "search authentication"
cccmemory help


## 支持的平台

|平台|状态|对话位置|
|----------|--------|----------------------|
|克劳德代码|✅ 支持| `~/.claude/projects/` |
|克劳德桌面|✅ 支持|(索引Claude代码历史)|
|食品法典|✅ 支持| `~/.codex/sessions/` |

**为什么今天只有Claude Code和Codex CLI?**
CCCMemory从稳定的、可解析的磁盘格式中索引本地会话历史。Claude Code和Codex CLI都以一致的模式在本地存储完整的对话日志。其他工具要么不公开完整的本地历史记录,要么只支持部分/手动保存,要么不提供稳定的文件格式来可靠地解析。没有确定性的本地存储,就没有安全的索引或恢复。

## 建筑```
Single Database (default)
└── ~/.cccmemory.db
├── projects + project_aliases
├── project_sources (global index)
└── conversations/messages/decisions/mistakes/...

Per-Project Databases (optional)
└── ~/.claude/projects/{project}/.cccmemory.db
└── {project}/.cccmemory/.cccmemory.db (sandbox fallback)

故障排除

Claude Desktop显示JSON解析错误

升级到v1.7.3+:```bash
npm update -g cccmemory


### Claude代码中未加载MCP

1. 检查配置位置是否 `~/.claude.json` (不是 `~/.claude/config.json`)
1. 验证JSON语法是否有效
1. 重新启动Claude代码

### 嵌入不起作用

检查提供商状态:```bash
cccmemory status

默认Transformers.js应该可以开箱即用。如果你选择加入Ollama,请确保它正在运行(ollama serve).

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Claude Conversation Memory MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Claude Conversation Memory MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Claude Conversation Memory MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Claude Conversation Memory MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Claude Conversation Memory MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Claude Conversation Memory MCP 能提供哪些能力?

资料显示约 19 个工具;能力标签包括 搜索、对话管理、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。