flatten-mcp

Name: flatten-mcp
Author: shayaShav

本地服务

github.com/shayaShavAI 与智能体0

代码仓库

关于 flatten-mcp

一个 MCP 服务，用于平展 Claude Code 会话——逐字保留每个提示词和事件，同时回收上下文令牌，以便以较低令牌数恢复完全相同的原始对话，而不是将其压缩成有损摘要。它将庞大的工具输出（大文件 r

#mcp #model-context-protocol #claude #claude-code #context-window #tokens #session #history #flatten #compaction

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "flatten": {
      "command": "npx",
      "args": [
        "-y",
        "flatten-mcp"
      ]
    }
  }
}

启动命令npx -y flatten-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmflatten-mcpstdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
session_id	string	否	会话 UUID、"last"、"last N" 或 "current"。省略时会展平当前实时会话（claude）；在 codex 下，"current" 会回退为 "last"。
sessionId	string	否	session_id 的 camelCase 别名（用于确保 camelCase 调用不会导致验证失败）。
agent	enum	否	要定位其会话存储的 Agent："claude"（默认）或 "codex"。claude \| codex
project_dir	string	否	项目的绝对路径。默认值：CLI 运行所在的项目（cwd）。在 codex 下，会将 "last"／"last N"／关键字限定为 cwd 等于此目录的 rollout。
claude_dir	string	否	要定位其会话的 Claude 配置目录的绝对路径（或 ~/...）——即包含 projects/ 的目录。默认值：若已设置则为 $CLAUDE_CONFIG_DIR，否则为 ~/.claude。仅适用于 Agent "claude"。
codex_home	string	否	要处理其会话的 Codex 主目录的绝对路径（或 ~/...）——即包含 sessions/ 的目录。默认值：如果设置了 $CODEX_HOME，则使用该变量；否则使用 ~/.codex。仅适用于 agent "codex"。
min_size	number	否	仅展平大于 N 字节的工具结果
dry_run	boolean	否	报告将要展平的内容，但不修改文件
include_tool_use_result	boolean	否	同时展平 Claude Code 为每行结果保留的顶层 toolUseResult 镜像（磁盘节省量大约翻倍；可无损恢复）。设为 false 则仅处理 message.content。
breakdown	any	否	包含已展平内容的按工具/资源分类明细。false、true 或 "summary" = 汇总的自适应行以及 byKind/bySlot 分组；"deep" 还会在对应行下列出每个单独块（工具 + 参数摘要 + 字节数 + 每块的 token 估算值），按上下文 token 数排序分组，块按字节数排序。试运行始终至少包含摘要；设为 true/"summary"/"deep" 也会在实际展平时包含明细。