Sovant Claude Code MCP

🚀 sovant-claude-code-mcp

Sovant MCP 是 Claude Code 的本地适配器，它能为每个代码仓库提供明确且可控的长期记忆功能。

🚀 快速开始

前提条件

• 已安装并能正常使用 Claude Code
• 安装 Node.js 18 及以上版本
• 获取 Sovant API 密钥（可在 sovant.ai/dashboard/keys 免费获取）

安装步骤

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 应该能召回你刚刚保存的记忆。如果以上操作都能正常工作，说明你已完成安装。

✨ 主要特性

功能概述

• 仅显式记忆：每一条记忆都是通过有意的工具调用写入的，不会自动捕获任何内容。
• 一个仓库对应一个记忆线程：默认情况下，每个 Git 仓库对应一个 Sovant 线程。
• 按仓库划分范围：每个 Git 仓库都有自己的记忆线程，除非你明确进行全局搜索，否则记忆不会在项目之间泄露。
• MCP 本地运行：此适配器作为本地标准输入输出进程与 Claude Code 一起运行，通过 HTTPS 与 Sovant API 进行通信。
• 记忆存储在 Sovant 云端：记忆会被持久化保存，可在 Sovant 仪表盘上进行搜索和管理。

不具备的功能

• 无自动捕获功能，没有后台监听器，不存在被动记忆。
• 无静默召回功能，只有在明确请求时才会检索上下文。
• 无范围扩展功能，按仓库范围的搜索将保持在仓库范围内，全局搜索需要明确选择启用。

💻 使用示例

可用工具

召回参数

📦 卸载方法

claude mcp remove sovant

此命令将从 Claude Code 中移除 MCP 注册信息。已存储在 Sovant 中的记忆不会被删除，你可以在 Sovant 仪表盘 上进行管理。

📚 详细文档

• 问题反馈：github.com/sovant-ai/sovant-claude-code-mcp/issues — 请提供你的操作系统、Node 版本和 claude --version 信息。
• 文档参考：sovant.ai/docs/mcp

📄 许可证

本仓库中的 MCP 适配器代码采用 MIT 许可证。

记忆存储和检索由 Sovant 托管服务（sovant.ai）提供。使用需遵守 Sovant 的服务条款。