Sovant Claude Code MCP

Sovant MCP is a local adapter designed for Claude Code, providing independent long - term memory storage services for each code repository through explicit tool calls. Memories are stored in the cloud and can be managed.

Knowledge management and memory Developer tools #Explicit memory #Repository isolation #Local adapter #Memory management .TypeScript

rating : 2 points

downloads : 8.1K

update time : 2026-03-13

Open Site

What is Sovant Claude Code MCP?

Sovant MCP is an intelligent memory assistant specifically designed for Claude Code (Anthropic's code editor). It enables the AI assistant to remember important information in your different projects, such as technical decisions, coding specifications, database configurations, etc. Each Git repository has an independent memory space to ensure that information is not confused.

How to use Sovant MCP?

After installation, you can directly use specific memory commands when chatting with the AI in Claude Code. For example, tell the AI "Remember: We use PostgreSQL 16". Then, at any time, when you ask "What database do we use?", the AI can answer accurately. All memories are stored in the Sovant cloud and can be managed through the web dashboard.

Applicable scenarios

It is very suitable for scenarios such as team collaborative development, long-term project maintenance, and parallel development of multiple projects. When you need to ensure the consistency of technical decisions, avoid repeated explanations of project specifications, or maintain context continuity between different sessions, Sovant MCP can be very helpful.

Main features

Explicit memory

All memories need your explicit instruction to save. There is no automatic capture or background listening, and it is completely under your control.

Repository isolation

Each Git repository corresponds to an independent memory thread, and information from different projects will not interfere with each other.

Local operation

The MCP adapter runs locally and communicates with Claude Code through standard input and output to ensure response speed.

Cloud storage

Memories are stored in the Sovant cloud, supporting search, management, and persistent storage, and can be accessed through the web dashboard.

Privacy by default

By default, only development memories saved through Claude Code are retrieved, excluding data from other sources such as dashboards and CRMs.

Rich toolset

It provides 10 different memory tools, including complete functions such as saving, retrieving, searching, listing, editing, and deleting.

Advantages

Fully controllable: All memories need explicit instructions to save, without automatic capture.

Project isolation: Each repository has independent memory to avoid information confusion.

Persistent storage: Cloud storage ensures that memories will not be lost when the session ends.

Easy to manage: All memories can be viewed and managed through the web dashboard.

Privacy protection: By default, only development memories are retrieved to protect sensitive information.

Flexible search: Supports both in - thread search and global search modes.

Limitations

Manual saving required: It will not automatically remember the conversation content.

Network - dependent: It needs to be connected to the Sovant cloud service.

API key required: You need to register to obtain a free API key.

Only for Claude Code: Currently, it only supports Anthropic's Claude Code editor.

How to use

Installation preparation

Ensure that Claude Code and Node.js 18+ are installed, and obtain the Sovant API key.

Clone and build

Download the MCP adapter code and build it.

Verify installation

Restart Claude Code and test the memory function.

Usage examples

Save the project technology stack

At the beginning of a new project, record the technology stack and version used in the project.

Record architectural decisions

Record important technical decisions and reasons.

Save team coding specifications

Record the team's coding conventions and best practices.

Maintain context across sessions

Maintain project context between different work sessions.

Frequently Asked Questions

Where are the memories stored? Is it safe?

Will the memories between different projects be confused?

How to delete unwanted memories?

What types of memories are supported?

Are there any limits on the number or size of memories?

Will the memories be lost after uninstallation?

Related resources

Official documentation

Complete MCP adapter usage documentation and API reference.

GitHub repository

Source code, issue feedback, and contribution guidelines.

API key management

Obtain and manage your Sovant API key.

Sovant dashboard

Web interface for online management of all memories.

Claude Code documentation

Official documentation for the Claude Code editor.

Terms and conditions for using the Sovant service.

🚀 sovant-claude-code-mcp

Sovant MCP is a local adapter for Claude Code, which enables explicit, governed long - term memory for each repository.

🚀 Quick Start

Sovant MCP allows you to manage long - term memory for each repository in a controlled way. To get started, follow the installation and verification steps below.

✨ Features

What this does

Explicit memory only: Every memory is written by a deliberate tool call, and nothing is captured automatically.
One repo = one memory thread: Each git repository maps to a single Sovant thread by default.
Scoped per repository: Each git repo has its own memory thread. Memories don't leak between projects unless you explicitly search globally.
MCP runs locally: This adapter runs as a local stdio process alongside Claude Code and communicates with the Sovant API over HTTPS.
Memory stored in Sovant cloud: Memories are persisted, searchable, and manageable from the Sovant dashboard.

What this does NOT do

No auto - capture, no background listener, and no passive memory.
No silent recall. Context is only retrieved when explicitly requested.
No scope expansion. Repo - scoped searches stay repo - scoped. Global search requires an explicit opt - in.

📦 Installation

Prerequisites

Claude Code installed and working
Node.js 18+
A Sovant API key (free at sovant.ai/dashboard/keys)

Installation Steps

git clone https://github.com/sovant-ai/sovant-claude-code-mcp.git
cd sovant-claude-code-mcp
npm install
npm run build

Then register with 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

Replace /absolute/path/to/ with the actual path on your machine.

💻 Usage Examples

Basic Usage

Restart Claude Code, then try:

> "Remember: we use PostgreSQL 16 with JSONB for the main database"

Claude will confirm the memory was saved via Sovant, including a short memory ID. Then:

> "What database do we use?"

Sovant should recall the memory you just saved. If both work, you're set.

Available Tools

Tool	Description
`sovant_remember`	Save a general note or fact
`sovant_remember_pref`	Save a coding preference
`sovant_remember_decision`	Save an architectural decision
`sovant_recall`	Retrieve relevant memories (dev - only by default; supports `scope`, `mode`, `debug`, `include_workspace`)
`sovant_search`	Search with explicit scope (`repo` or `global`)
`sovant_memory_list`	List recent memories with short IDs
`sovant_memory_show`	Show full details of a memory
`sovant_memory_update`	Edit a memory's content
`sovant_memory_delete`	Delete a memory
`sovant_thread_info`	Show current thread ID, repo, and memory count

Privacy Default

By default, sovant_recall only returns dev memories — those tagged with source:claude - code (i.e., memories saved through this MCP adapter). Dashboard memories, CRM records, and smart - capture data are excluded.

To include all workspace memories in a recall, pass include_workspace: true.

Recall Parameters

Parameter	Type	Default	Description
`query`	string	(required)	The search query
`limit`	number	10	Max results (max 25)
`scope`	`"thread"` \| `"global"`	`"thread"`	`thread` = current repo only; `global` = all projects
`mode`	`"smart"` \| `"exact"`	`"smart"`	`smart` = hybrid AI recall; `exact` = keyword match
`debug`	boolean	false	Append debug info (token counts, sources)
`include_workspace`	boolean	false	Include non - dev memories (dashboard, CRM, smart capture)

📚 Documentation

Uninstall

claude mcp remove sovant

This removes the MCP registration from Claude Code. Memories already stored in Sovant are not deleted — you can manage them from the Sovant dashboard.

Help and Feedback

Issues: github.com/sovant-ai/sovant-claude-code-mcp/issues — please include your OS, Node version, and claude --version.
Docs: sovant.ai/docs/mcp

📄 License

The MCP adapter code in this repository is MIT licensed.

Memory storage and retrieval are provided by the Sovant managed service (sovant.ai). Usage is subject to Sovant's terms of service.

sovant_remember

Save notes, facts, or context to the project memory. Used for general notes in the project.

Parameters

text : string*

Description

Text to remember

sovant_remember_pref

Save user preferences to the project memory. Used for coding style preferences, tool selection, etc.

Parameters

text : string*

Description

Preference to remember

sovant_remember_decision

Save important decisions to the project memory. Used for architectural decisions, technology selection, trade - off analysis.

Parameters

text : string*

Description

Decision to remember

sovant_recall

Search for relevant context in the project memory, with the scope limited to the thread of the current repository. Used to find past decisions, preferences, or notes.

Parameters

query : string*

Description

Search query or question

Parameters

limit : number*

Description

Maximum number of results to return (default: 10, maximum: 25)

Parameters

scope : string*

Description

Search scope: 'thread' (default, current repository) or 'global' (all projects)

Parameters

mode : string*

Description

Recall mode: 'smart' (default, mixed AI recall) or 'exact' (deterministic keyword matching)

Parameters

debug : boolean*

Description

Include debugging information (count, token estimate, source)

Parameters

include_workspace : boolean*

Description

Include non - development memories (dashboard, CRM, intelligent capture). Default: false (only development memories)

sovant_memory_list

List recent project memories, including short IDs required for display/updating/deletion.

Parameters

count : number*

Description

Number of memories to list (default: 20, maximum: 100)

sovant_memory_delete

Delete a memory by ID. Use the short ID from /memory list.

Parameters

memory_id : string*

Description

Memory ID to delete (full or short ID)

sovant_memory_update

Update the content of an existing memory. Use the short ID from /memory list.

Parameters

memory_id : string*

Description

Memory ID to update (full or short ID)

Parameters

text : string*

Description

New content of the memory

sovant_memory_show

Display the full details of a specific memory, including tags, metadata, and creation date.

Parameters

memory_id : string*

Description

Memory ID to display (full or short ID)

sovant_search

Search for memories using an explicit scope. Defaults to the current repository (safe). Use scope='global' to search across all projects.

Parameters

query : string*

Description

Search query

Parameters

scope : string*

Description

Search scope: 'repo' (default, only current project) or 'global' (all projects)

Parameters

tags : string*

Description

Comma - separated tags for filtering

Parameters

type : string*

Description

Memory type filter (e.g., 'decision', 'preference')

Parameters

limit : number*

Description

Maximum number of results to return (default: 10, maximum: 20)

sovant_thread_info

Get information about the current project memory thread, including the thread title, memory count, and creation date.

Markdownify MCP

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Python

24.8K

4.5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

37.3K

5 points

Figma Context MCP

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

TypeScript

106.7K

4.7 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご

Sovant Claude Code MCP

Overview

Tools List

Content Details

Alternatives

What is Sovant Claude Code MCP?

How to use Sovant MCP?

Applicable scenarios

Main features

How to use

Usage examples

Frequently Asked Questions

Related resources

Installation

🚀 sovant-claude-code-mcp

🚀 Quick Start

✨ Features

What this does

What this does NOT do

📦 Installation

Prerequisites

Installation Steps

💻 Usage Examples

Basic Usage

Available Tools

Privacy Default

Recall Parameters

📚 Documentation

Uninstall

Help and Feedback

📄 License

Alternatives