ccfolio (Hippensteel)

MCP搜索检索

提供方 Hippensteel

搜索检索 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

ccfolio是一款用于索引、搜索和归档Claude Code对话的工具,提供成本跟踪、Obsidian导出和会话恢复功能。

一句话选型结论

按资料字段整理

ccfolio (Hippensteel) 属于搜索检索类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

对话管理Python本地部署全文搜索成本跟踪Obsidian集成会话恢复

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
pip install ccfolio

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

资料聚合

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

情报与竞品检索

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

选择建议

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

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ccfolio (Hippensteel)当前 5 stdio · 本地进程 本地部署 有 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

服务器档案

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

详细介绍

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

ccfolio

索引、搜索和归档您的Claude Code对话。跟踪成本、导出到黑曜石,并允许您在不丢失上下文的情况下恢复过去的会话。

它的作用

Claude Code将每个对话存储为JSONL文件 ~/.claude/projects/.cfolio将它们索引到本地SQLite数据库中,并为您提供:

  • 全文搜索 在所有对话中,包括子代理内容
  • 成本跟踪 --每日、每月、按型号、按项目
  • 黑曜石出口 与Dataview/Bases兼容的frontmatter
  • 自动生成的标题 从项目上下文和第一提示关键字
  • 会话恢复 --直接移交给 claude --resume 按索引、slug或ID前缀
  • MCP服务器 --从活动的Claude Code对话中搜索过去的会话
  • 子代理链接 --与父会话链接的代理工件,未作为噪声索引

安装```bash

pip install ccfolio

With MCP server support

pip install ccfolio[mcp]


然后运行安装程序:```bash
ccfolio config init

这将设置您的黑曜石保管库路径并配置自动同步挂钩。

自动同步

将此添加到您的 ~/.zshrc 在每次Claude Code会话后自动同步:```bash
claude() {
command claude "$@"
ccfolio update --quiet
}


之后,每次退出时,ccfolio都会悄无声息地运行 `claude` 会议。

## 命令

### 浏览```bash
ccfolio list                     # All sessions, newest first
ccfolio list --recent 20         # Last 20
ccfolio list --sort cost         # Most expensive first
ccfolio list --sort messages     # Most messages first
ccfolio list --favorites         # Only favorites
ccfolio list --model opus        # Filter by model
ccfolio list --after 2026-02-01  # After a date

搜索```bash

ccfolio search "tailscale"
ccfolio search "hypothesis engine"
ccfolio search "CLAUDE.md"


搜索用户消息、助理响应、摘要、文件路径和子代理内容。支持部分单词-- `ccfolio search "folio"` 查找包含“ccfolio”的会话。```bash
# Find sessions that touched a specific file
ccfolio files "CLAUDE.md"
ccfolio files "fetch_daily.py"

视图```bash

ccfolio show #1 # By list index
ccfolio show giggly-pondering # By slug (partial match works)
ccfolio show 0c560d # By ID prefix
ccfolio show #1 --raw # Raw JSON record


### 简历```bash
ccfolio resume #1                # Resume most recent session
ccfolio resume giggly-pondering  # Resume by slug
ccfolio resume #3 --fork         # Fork into a new session

结束会议并移交给 claude --resume。永远不要失去背景。

成本```bash

ccfolio cost # Daily breakdown
ccfolio cost --monthly # Monthly breakdown
ccfolio cost --model # By model
ccfolio cost --project # By project directory
ccfolio cost --after 2026-02-01 # Date range


显示估计的API成本以及您的使用情况。即使在Max订阅中,也有助于了解代币的去向。

### 统计```bash
ccfolio stats                    # Overview: sessions, messages, tokens, cost
ccfolio stats --tools            # Tool usage breakdown

组织```bash

ccfolio fav #3 # Toggle favorite
ccfolio tag #3 infrastructure # Add tags
ccfolio untag #3 infrastructure # Remove tags
ccfolio rename #3 "My Title" # Set custom title


### 出口到黑曜石```bash
ccfolio export #3                # Export single session
ccfolio export --all             # Export all un-exported sessions
ccfolio export --all --force     # Re-export everything
ccfolio export --all --redact-paths  # Strip username from file paths

导出通过以下方式自动发生 ccfolio update。手动导出可一次性使用。

MCP服务器

ccfolio可以作为MCP服务器运行,让Claude在活动对话中搜索过去的会话。

增添 ~/.claude.json 在您的项目路径下:```json
{
"projects": {
"/Users/yourname": {
"mcpServers": {
"ccfolio": {
"command": "/path/to/.venv/bin/ccfolio",
"args": ["mcp"]
}
}
}
}
}


可用工具: `search_sessions`, `list_recent_sessions`, `find_sessions_for_file`, `get_session_details`, `get_cost_summary`.

## 会话ID快捷方式

您永远不需要键入完整的UUID:

|格式|示例|
|--------|---------|
|上次索引 `list` | `#1`, `#12` |
|蛞蝓(部分)| `giggly`, `giggly-pondering` |
|ID前缀| `0c560d` |

## 黑曜石输出

导出的会话将通过frontmatter放置在您配置的vault路径中:```yaml
type: Claude-Session
session_id: "0c560d4a-..."
slug: giggly-pondering-gem
date: 2026-02-14
model: claude-opus-4-6
messages: 159
tool_calls: 50
cost_usd: 11.95
favorite: false
tags: [Claude-Session, Opus]

工具调用呈现为可折叠的标注。vault笔记的文件路径变为维基链接。使用子代理的会话会得到一个链接的子代理部分。

汽车标题

没有自定义的会话 /rename title在同步过程中自动获取基于主题的名称。ccfolio从项目目录、最常接触的文件路径和第一个提示关键字中提取主题。

格式: Topic1 + Topic2 + Topic3 (最多4个主题)。没有LLM调用,没有API成本。

需求

  • Python 3.10+
  • 克劳德代码(claude CLI)
  • 黑曜石(可选,用于vault导出)

配置```bash

ccfolio config show # View current settings
ccfolio config init # Interactive setup
```

配置文件: ~/.config/ccfolio/config.toml
数据库: ~/.config/ccfolio/ccfolio.db

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
ccfolio (Hippensteel) 怎么安装?

在客户端按下面的安装命令接入:pip install ccfolio。装完在客户端配置里引用同一个包或端点。

ccfolio (Hippensteel) 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

ccfolio (Hippensteel) 收费吗?

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

ccfolio (Hippensteel) 需要 API Key 吗?

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

ccfolio (Hippensteel) 支持哪些客户端?

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

ccfolio (Hippensteel) 能提供哪些能力?

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

ccfolio (Hippensteel) 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

ccfolio (Hippensteel) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

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

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