English Français العربية

io.github.sharedmemoryai/memory

Registre officiel IA et agents

Persistent memory for AI agents. Remember, recall, and explore a shared knowledge graph.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @sharedmemory/mcp-server
Claude Code 
claude mcp add memory -e 'SHAREDMEMORY_API_KEY=<your sharedmemory_api_key>' -e 'SHAREDMEMORY_API_URL=<SHAREDMEMORY_API_URL>' -e 'SHAREDMEMORY_VOLUME_ID=<SHAREDMEMORY_VOLUME_ID>' -- npx -y @sharedmemory/mcp-server@2.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@sharedmemory/mcp-server@2.1.1"
            ],
            "env": {
                "SHAREDMEMORY_API_KEY": "<your sharedmemory_api_key>",
                "SHAREDMEMORY_API_URL": "<SHAREDMEMORY_API_URL>",
                "SHAREDMEMORY_VOLUME_ID": "<SHAREDMEMORY_VOLUME_ID>"
            }
        }
    }
}

Variables d'environnement

  • SHAREDMEMORY_API_KEY obligatoire secret Your SharedMemory API key
  • SHAREDMEMORY_API_URL API endpoint URL
  • SHAREDMEMORY_VOLUME_ID Default volume/project ID

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @sharedmemory/mcp-server
  2. Quick Install (Recommended)
  3. Manual Setup
  4. Configuration
  5. Available tools
  6. Resources
  7. Prompts
  8. Documentation
  9. License

@sharedmemory/mcp-server

Model Context Protocol server for SharedMemory. Gives Claude Code, Claude Desktop, Cursor, VS Code Copilot, and other MCP-compatible tools persistent memory.

The fastest way to set up SharedMemory — one command, no JSON editing:

# Interactive — picks your client, asks for your API key
npx -y @sharedmemory/mcp-server install

# Or specify everything inline
npx -y @sharedmemory/mcp-server install --cursor --api-key sm_live_... --volume your-volume-id

# Install for all supported clients at once
npx -y @sharedmemory/mcp-server install --all --api-key sm_live_...

Supported clients: --claude-code, --claude, --cursor, --vscode, --windsurf, --all

Manual Setup

If you prefer to edit config files yourself:

Claude Code

One command:

claude mcp add sharedmemory -- npx -y @sharedmemory/mcp-server

Or with env vars:

claude mcp add --env SHAREDMEMORY_API_KEY=sm_live_... \
  --env SHAREDMEMORY_VOLUME_ID=your-volume-id \
  sharedmemory -- npx -y @sharedmemory/mcp-server

Or create .mcp.json in your project root to share with your team:

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "${SHAREDMEMORY_API_KEY}",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "${SHAREDMEMORY_VOLUME_ID}"
      }
    }
  }
}

Tip: Copy the included CLAUDE.md into your project root to teach Claude Code when and how to use SharedMemory proactively.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}
Cursor

.cursor/mcp.json in your project root:

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}
VS Code Copilot

.vscode/mcp.json:

{
  "servers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}
Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}

Configuration

VariableRequiredDefaultDescription
SHAREDMEMORY_API_KEYYes—Agent API key
SHAREDMEMORY_API_URLNohttps://api.sharedmemory.aiAPI endpoint
SHAREDMEMORY_VOLUME_IDNo—Default volume

Available tools

ToolDescription
rememberStore a fact or note
queryRetrieve context BEFORE answering — semantic search over memories
get_entityGet entity details and relationships
search_entitiesSearch entities by name
get_graphKnowledge graph overview
list_volumesList accessible volumes
delete_memoryDelete a memory by ID
update_memoryUpdate a memory by ID
feedbackSubmit feedback on memory relevance
batch_rememberStore multiple memories at once
get_memoryRetrieve a specific memory by ID
get_profileAuto-generated user profile from memories
get_contextGet a context block for LLM prompting
set_instructionStore a persistent rule all agents will follow
list_instructionsList all active instructions for a volume
list_documentsList uploaded documents

Resources

URIDescription
memory://graphKnowledge graph for the default volume

Prompts

NameDescription
summarize-knowledgeSummarize all knowledge in a volume
what-do-you-know-aboutRetrieve everything known about a topic

Documentation

https://docs.sharedmemory.ai/sdks/mcp-server

License

MIT

Questions fréquentes

Qu'est-ce que io.github.sharedmemoryai/memory ?

Persistent memory for AI agents. Remember, recall, and explore a shared knowledge graph.

Comment installer io.github.sharedmemoryai/memory ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add memory -e 'SHAREDMEMORY_API_KEY=<your sharedmemory_api_key>' -e 'SHAREDMEMORY_API_URL=<SHAREDMEMORY_API_URL>' -e 'SHAREDMEMORY_VOLUME_ID=<SHAREDMEMORY_VOLUME_ID>' -- npx -y @sharedmemory/mcp-server@2.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.sharedmemoryai/memory ?

Oui. Il attend SHAREDMEMORY_API_KEY, à renseigner dans sa configuration.

io.github.sharedmemoryai/memory est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.sharedmemoryai/memory ?

Il est publié par sharedmemoryai. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.