使用说明
索万特克劳德码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" |
mode |
"smart" |
"exact" |
"smart" |
debug |
boolean | false | 附加调试信息（令牌计数、源代码） |
include_workspace |
boolean | false | 包括非开发内存（仪表板、CRM、智能捕获） |
卸载
claude mcp remove sovant
这将从Claude Code中删除MCP注册。已存储在Sovant中的内存不会被删除，您可以从 Sovant仪表板.
帮助和反馈
- 问题： github.com/sovant-ai/sovant-claude-mcp/issues --请包括您的操作系统、节点版本和
claude --version. - 文件： sovant.ai/docs/mcp
许可证
此存储库中的MCP适配器代码是MIT许可的。
内存存储和检索由Sovant管理服务提供(Sovant.ai).使用取决于 Sovant的服务条款.
