卡瓦代码MCP
AI编码助手的团队意识记忆。跟踪意图，记录决策，并在提交之前实时查看队友何时编辑相同的代码。
@kawacode/mcp 是官方的吗 模型上下文协议 （MCP）服务器 Kawa代码它允许Claude Code、Cursor和任何兼容MCP的AI助手：
- 记住你在做什么 跨会话、分支和机器——不再需要每天早上重新解释架构。
- 在团队冲突发生之前 --知道队友何时在他们的工作副本中编辑相同的文件或功能 *马上*，在你们任何一方做出承诺之前。
- 用推理捕捉架构决策 --未来你（和未来的人工智能会话）将继承团队积累的上下文，而不是重新进行选择。
- 链接自动提交意图 --每次提交都会得到 *为什么* 附加，而不仅仅是差异。
先决条件
必需
- Node.js>=18.0.0 --MCP服务器的运行时
- Kawa代码 桌面应用程序正在运行 --kawa.mcp是一种薄型mcp到IPC适配器；所有git操作、存储和API通信都发生在Kawa代码中
可选（用于历史推断）
- 无烟煤API键 -您自己的Claude API密钥，作为参数传递给推理工具
- **** --支持更丰富的数据层（PR描述、审查评论、问题讨论）。没有
gh，第2层和第4层将自动跳过
安装
在AI配置中添加MCP，例如在Claude Code上：
claude mcp add -s user kawa-intents -- npx -y @kawacode/mcp
对于Cursor AI，安装MCP npm install -g @kawacode/mcp 并将其添加到 ~/.cursor/mcp.json.
{
"mcpServers": {
"kawa-intents": {
"command": "kawacode-mcp"
}
}
}请注意，在这种情况下，MCP不会自动更新到未来的版本。 要升级到较新版本，请运行 npm update -g @kawacode/mcp.
手动安装
对于您希望Kawa Code运行的项目，创建一个 .mcp.json 项目根目录中的文件（建议团队使用——将其提交到git）：
{
"mcpServers": {
"kawa-intents": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kawacode/mcp"]
}
}
}用法
MCP服务器与Kawa Code应用程序、Kawa Code IDE扩展以及Cursor AI和Claude Code等AI代码生成器协同工作。
编辑前决策检查（Claude Code挂钩）
可选。当代理即将编辑附加了先前记录的推理的代码时（重叠的意图块，或文件中的约束 relatedFiles)，在“编辑”触发之前，钩子会使其浮出水面。建议映射到行动：静默（继续）、注入咨询上下文（审查）或用stderr消息阻止(investigate-upstream).
将其连接为克劳德代码 PreToolUse 钩住你的 ~/.claude/settings.json 或项目 .claude/settings.json:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": "npx -y @kawacode/mcp kawacode-pre-edit-decision-check" }
]
}
]
}
}阻塞时覆盖路径：
- 持续（推荐）： 记录一个取代现有分叉决策的分叉决策，然后重试编辑。
record_decision(type: "fork", supersedes: [""], rationale: "...")- 一次性逃生舱： 添加
force: true钩子支持会话缓存中显示的决策，并允许编辑。Kawa Code守护进程重新启动时，缓存重置。
禁用会话的挂钩 KAWA_PRE_EDIT_CHECK=off.
本地遥测（日志）
每次预编辑检查触发（和强制覆盖）都会在以下位置将JSON行附加到每日轮换的文件中 ~/.kawa-code/logs/pre-edit-decision-check-YYYY-MM-DD.jsonl。日志是 仅限本地 --什么都不会离开你的机器。默认值保留过去30天，总计上限为100 MB（最旧的文件先删除）。
每一行都记录了触发的内容、原因以及过滤掉的内容，这对于调整推荐阈值和发现假阳性非常有用。
禁用遥测 KAWA_PRE_EDIT_TELEMETRY=off.
主要特点
- 实时团队冲突检测 --查看队友何时在他们的工作副本中编辑相同的文件或行， *在你们俩做出承诺之前*大多数版本控制工具在合并冲突后都会显示这一点；Kawa之前给你看过。
- 跨会话AI内存 --你的人工智能助手会在几天、几家分支机构和几台机器上继续前进。没有每天早上重新解释建筑。
- 具有推理能力的决策历史 --记录分叉、权衡和废弃的方法 *为什么*。未来的会话和队友继承上下文，而不是重新推导。
- 提交↔ 意图联系 --每个提交都会自动与驱动它的意图相关联。
git log显示发生了什么变化；Kawa展示了原因。 - 智能上下文检索 --基于相关性的加载；只有当前任务需要的东西。
- 零知识加密 --同步前在客户端加密的代码块。Kawa云无法解密您团队的代码。
- 跨平台 --可与Claude Code、Cursor和任何兼容MCP的AI助手配合使用。
发展
# Watch mode (auto-rebuild on file changes)
npm run dev
# Build TypeScript to JavaScript
npm run build
# Clean build artifacts
npm run clean
# Run the MCP server directly
npm start测试MCP服务器
要测试MCP服务器而不将其集成到AI助手中，请执行以下操作：
- 构建项目：
npm run build - 运行服务器：
npm start - 服务器通过stdio（标准输入/输出）进行通信
- 您可以通过stdin发送MCP协议消息以测试工具功能
开发技巧
- 使用
npm run dev在开发过程中进行自动重建 - 检查服务器日志的stderr（stdout保留用于MCP协议）
- 测试前确保Kawa代码正在运行
建筑
Claude Code / Cursor AI
↓ MCP Protocol (stdio)
kawa.mcp (this server)
↓ Huginn IPC (Unix socket / Named pipe)
Kawa Code Desktop App
└─ HTTP Client
↓ REST + SSE
Kawa API (cloud)
└─ Team sync & zero-knowledge encryption贡献
许可证
该项目来源于 Kawa代码源代码可用许可证。
您可以运行和修改软件以供个人或内部使用。
看 许可证 了解详情。