cass cm mcp
stdio 主控程序 桥接服务器 卡丝 （编码代理会话搜索）和 厘米 （cass内存系统）集成到一个工具服务器中，用于Claude Code、Codex CLI、Gemini CLI和其他MCP兼容的AI编码代理。
目前，cass和cm都没有提供可工作的stdio MCP服务器。这座桥用10个工具、优化的搜索输出和零外部Python依赖性填补了这一空白。
先决条件
两者 cass 和 cm 必须在你的 PATH 或通过环境变量指定。
快速安装
git clone https://github.com/krasmussen37/cass-cm-mcp.git
cd cass-cm-mcp
./install.sh安装程序：
- 检查Python 3.7+，
cass，以及cm可供使用 - 副本
cass-cm-mcp到~/.local/bin/ - 提示配置每个代理（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".
Codex CLI(~/.codex/config.toml)
[mcp_servers.cass-cm]
command = "/home/you/.local/bin/cass-cm-mcp"
args = []Codex使用TOML。将此块与其他块一起添加到文件中的任何位置 [mcp_servers.*] 条目。
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%），以节省代理上下文窗口。工作流程：
cass_search返回简短摘要：分数、标题、代码段、日期、代理、工作区和位置指针（source_path+line_number）- 代理扫描结果并识别有希望的命中
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 用于新会话的实时索引。
许可证
麻省理工学院-见 许可证.