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 的服務條款。