AI导哈

代码代理会话搜索与记忆系统桥接服务

一个将代码代理会话搜索（cass）和记忆系统（cm）桥接为单一工具的服务，适用于Claude Code、Codex CLI和Gemini CLI等MCP兼容的AI编码代理。

  • by krasmussen37
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 krasmussen37/cass-cm-mcp

使用说明

cass cm mcp

stdio 主控程序 桥接服务器 卡丝 （编码代理会话搜索）和 厘米 （cass内存系统）集成到一个工具服务器中，用于Claude Code、Codex CLI、Gemini CLI和其他MCP兼容的AI编码代理。

目前，cass和cm都没有提供可工作的stdio MCP服务器。这座桥用10个工具、优化的搜索输出和零外部Python依赖性填补了这一空白。

先决条件

依赖关系 版本 安装
Python 3.7+ 通常预装
卡丝 0.1.x 见cass回购
厘米 0.2.x 见cm回购

两者 cass 和 cm 必须在你的 PATH 或通过环境变量指定。

快速安装

git clone https://github.com/krasmussen37/cass-cm-mcp.git
cd cass-cm-mcp
./install.sh

安装程序：

  1. 检查Python 3.7+， cass，以及 cm 可供使用
  2. 副本 cass-cm-mcp 到 ~/.local/bin/
  3. 提示配置每个代理（Claude Code、Codex CLI、Gemini CLI）

配置特定代理

./install.sh --configure-claude    # Claude Code only
./install.sh --configure-codex     # Codex CLI only
./install.sh --configure-gemini    # Gemini CLI only
./install.sh --configure-all       # All three agents

手动安装

cp cass-cm-mcp ~/.local/bin/
chmod +x ~/.local/bin/cass-cm-mcp

然后手动配置您的代理（见下文）。

代理配置

每个CLI代理都以不同的格式存储MCP服务器配置。安装程序可以处理所有三个，但以下是手动设置以供参考。

克劳德代码(~/.claude.json)

{
  "mcpServers": {
    "cass-cm": {
      "command": "/home/you/.local/bin/cass-cm-mcp",
      "args": [],
      "env": {},
      "description": "Session search (cass) + procedural memory/playbook (cm)"
    }
  }
}

如果 cass-cm-mcp 在您的PATH中，您可以使用 "command": "cass-cm-mcp".

看 claude-code.json.example.

Codex CLI(~/.codex/config.toml)

[mcp_servers.cass-cm]
command = "/home/you/.local/bin/cass-cm-mcp"
args = []

Codex使用TOML。将此块与其他块一起添加到文件中的任何位置 [mcp_servers.*] 条目。

看 codex-config.toml.example.

Gemini CLI(~/.gemini/settings.json)

{
  "mcpServers": {
    "cass-cm": {
      "command": "/home/you/.local/bin/cass-cm-mcp",
      "args": []
    }
  }
}

Gemini使用类似于Claude Code的JSON，但不使用 env 或 description 领域。合并 cass-cm 进入你现有的 mcpServers 对象。

看 gemini-settings.json.example.

配置格式摘要

代理 配置文件 格式 MCP密钥
克劳德代码 ~/.claude.json JSON mcpServers
Codex CLI ~/.codex/config.toml 汤姆 [mcp_servers.*]
Gemini CLI ~/.gemini/settings.json JSON mcpServers

配置更改后重新启动代理会话。

工具

会话搜索（cass）

工具 说明
cass_search 搜索所有编码代理会话历史记录。返回带有相关性得分的简短摘要。
cass_expand 深入搜索热门内容，查看周围的完整对话消息。
cass_timeline 一段时间内所有编码代理的活动时间线。
cass_stats 关于索引会话数据的统计信息。

程序记忆（cm）

工具 说明
cm_context 获取任务的相关剧本规则和历史记录。开始工作前使用
cm_playbook_list 列出所有带有置信度分数的活动剧本规则。
cm_playbook_add 将新的经验教训规则添加到剧本中。
cm_playbook_mark 对剧本规则给出反馈（有益/有害）。
cm_reflect 从最近的会话中自动提取新的剧本规则（速度慢，使用LLM）。
cm_doctor 内存系统的运行状况检查。

两层搜索工作流

搜索结果故意紧凑（比原始cass输出小约63%），以节省代理上下文窗口。工作流程：

  1. cass_search 返回简短摘要：分数、标题、代码段、日期、代理、工作区和位置指针（source_path+line_number）
  2. 代理扫描结果并识别有希望的命中
  3. cass_expand 针对完整的对话背景，深入探讨特定的热门话题

这可以防止一次搜索消耗数千个代理上下文令牌。

环境变量

变量 默认值 描述
CASS_BIN 从PATH自动检测 路径到 cass 二进制
CM_BIN 从PATH自动检测 路径到 cm 二进制
GEMINI_API_KEY - 自动桥接到 GOOGLE_GENERATIVE_AI_API_KEY cm反射
CASS_CM_MCP_DEBUG unset 设置为 1 保持stderr打开以进行故障排除

CLI使用情况

cass-cm-mcp              # Start MCP server (reads JSON-RPC from stdin)
cass-cm-mcp --version    # Print version
cass-cm-mcp --help       # Print usage

故障排除

“缺少必需的二进制文件” -未找到cass或cm。安装它们并确保它们在您的PATH上，或设置 CASS_BIN/CM_BIN 环境变量。

cm_reflect失败 -需要LLM API密钥。集 GEMINI_API_KEY 在您的环境或MCP服务器中 env 配置：

"env": {
  "GEMINI_API_KEY": "your-key-here"
}

调试模式 -设置 CASS_CM_MCP_DEBUG=1 在MCP env配置中查看stderr输出以进行故障排除。

停滞的会议 -快跑 cass index 重新索引或开始 cass index --watch 用于新会话的实时索引。

许可证

麻省理工学院-见 许可证.

相关 MCP