memory

@sharedmemory/mcp-server

适用于 SharedMemory 的 Model Context Protocol 服务。为 Claude Code、Claude Desktop、Cursor、VS Code Copilot 和其他兼容 MCP 的工具提供持久记忆。

快速安装（推荐）

设置 SharedMemory 的最快方式——只需一条命令，无需编辑 JSON：

# 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_...

支持的客户端：--claude-code、--claude、--cursor、--vscode、--windsurf、--all

手动设置

如果你更愿意自行编辑配置文件：

Claude Code

一条命令：

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

或者使用环境变量：

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

也可以在项目根目录创建 .mcp.json，与团队共享：

{
  "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}"
      }
    }
  }
}

提示： 将随附的 CLAUDE.md 复制到项目根目录，告诉 Claude Code 何时以及如何主动使用 SharedMemory。

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：

{
  "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"
      }
    }
  }
}

配置

变量	必填	默认值	说明
SHAREDMEMORY_API_KEY	是	—	Agent API 密钥
SHAREDMEMORY_API_URL	否	https://api.sharedmemory.ai	API 端点
SHAREDMEMORY_VOLUME_ID	否	—	默认卷

可用工具

工具	说明
remember	存储事实或笔记
query	回答前检索上下文——对记忆进行语义搜索
get_entity	获取实体详情及关联关系
search_entities	按名称搜索实体
get_graph	查看知识图谱概览
list_volumes	列出可访问的卷
delete_memory	按 ID 删除记忆
update_memory	按 ID 更新记忆
feedback	提交有关记忆相关性的反馈
batch_remember	一次存储多条记忆
get_memory	按 ID 获取指定记忆
get_profile	根据记忆自动生成用户档案
get_context	获取用于大模型提示的上下文块
set_instruction	存储所有 Agent 都会遵循的持久规则
list_instructions	列出某个卷的所有有效指令
list_documents	列出已上传的文档

资源

URI	说明
memory://graph	默认卷的知识图谱

提示词

名称	说明
summarize-knowledge	总结某个卷中的所有知识
what-do-you-know-about	检索有关某个主题的所有已知信息

文档

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

许可证

MIT