索万特克劳德码mcp
Sovant MCP是Claude Code的本地适配器，可为每个存储库启用显式、受管理的长期内存。
这有什么作用
- 仅限显式内存。 每一个记忆都是由一个深思熟虑的工具调用编写的。没有什么是自动捕获的。
- 一个repo=一个内存线程。 默认情况下，每个git存储库都映射到一个Sovant线程。
- 按存储库确定范围。 每个git repo都有自己的内存线程。除非你明确地全局搜索，否则记忆不会在项目之间泄露。
- MCP在本地运行。 此适配器与Claude Code一起作为本地stdio进程运行。它通过HTTPS与Sovant API进行对话。
- 存储在Sovant云中的内存。 记忆在Sovant仪表板上是持久的、可搜索的和可管理的。
这没有做什么
- 没有自动捕捉。没有背景听众。没有被动记忆。
- 没有沉默的回忆。只有在明确请求时才会检索上下文。
- 无范围扩展。回购范围的搜索保持回购范围。全局搜索需要明确的选择加入。
需求
- 克劳德代码 安装和工作
- Node.js 18+
- Sovant API密钥（免费 sovant.ai/仪表板/按键)
安装
git clone https://github.com/sovant-ai/sovant-claude-code-mcp.git
cd sovant-claude-code-mcp
npm install
npm run build然后用Claude Code注册：
claude mcp add sovant \
--transport stdio \
--env SOVANT_API_KEY=sk_live_your_key_here \
-- node /absolute/path/to/sovant-claude-code-mcp/dist/index.js替换 /absolute/path/to/ 使用机器上的实际路径。
验证
重新启动Claude Code，然后尝试：
> "Remember: we use PostgreSQL 16 with JSONB for the main database"Claude将确认内存已通过Sovant保存，包括一个短内存ID。然后：
> "What database do we use?"Sovant应该记得你刚刚保存的记忆。如果两者都有效，你就做好了准备。
可用工具
| 工具 | 说明 |
|---|---|
sovant_remember | 保存一般注释或事实 |
sovant_remember_pref | 保存编码首选项 |
sovant_remember_decision | 保存架构决策 |
sovant_recall | 检索相关内存（默认情况下仅限开发人员；支持 scope, mode, debug, include_workspace) |
sovant_search | 具有明确范围的搜索(repo 或 global) |
sovant_memory_list | 用短ID列出最近的记忆 |
sovant_memory_show | 显示内存的完整详细信息 |
sovant_memory_update | 编辑内存内容 |
sovant_memory_delete | 删除内存 |
sovant_thread_info | 显示当前线程ID、仓库和内存计数 |
隐私默认值
默认情况下， sovant_recall 只返回 dev存储器 --那些标记为 source:claude-code （即通过此MCP适配器保存的存储器）。仪表板内存、CRM记录和智能捕获数据被排除在外。
要将所有工作区记忆包含在回忆中，请传递 include_workspace: true.
召回参数
| 参数 | 类型 | 默认值 | 说明 | |
|---|---|---|---|---|
query | string | （必填） | 搜索查询 | |
limit | number | 10 | 最大结果数（最多25个） | |
scope | "thread" | "global" | "thread" | thread =仅限当前回购； global =所有项目 |
mode | "smart" | "exact" | "smart" | smart =混合AI召回； exact =关键字匹配 |
debug | boolean | false | 附加调试信息（令牌计数、源代码） | |
include_workspace | boolean | false | 包括非开发内存（仪表板、CRM、智能捕获） |
卸载
claude mcp remove sovant这将从Claude Code中删除MCP注册。已存储在Sovant中的内存不会被删除，您可以从 Sovant仪表板.
帮助和反馈
- 问题： --请包括您的操作系统、节点版本和
claude --version. - 文件： sovant.ai/docs/mcp
许可证
此存储库中的MCP适配器代码是MIT许可的。
内存存储和检索由Sovant管理服务提供(Sovant.ai).使用取决于 Sovant的服务条款.