AI导哈

语义记忆服务

MemoClaw MCP Server 是一个为AI代理提供语义记忆服务的模型上下文协议服务器，支持存储、检索和管理记忆，并提供向量搜索功能。

  • by anajuliabit
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 anajuliabit/memoclaw-mcp

使用说明

MemoClaw MCP服务器

MCP（模型上下文协议）服务器 MemoClaw --AI代理的语义记忆。使用矢量搜索存储、回忆和管理记忆。每个钱包100个免费API调用，无需注册。

安装

npm install -g memoclaw-mcp

配置

通过环境变量或配置文件设置私钥：

# Option 1: env var
export MEMOCLAW_PRIVATE_KEY=0x...

# Option 2: config file (created by `memoclaw init`)
# ~/.memoclaw/config.json → { "privateKey": "0x...", "url": "https://api.memoclaw.com" }

可选择设置自定义API URL：

export MEMOCLAW_URL=https://api.memoclaw.com  # default
export MEMOCLAW_TIMEOUT=30000                 # request timeout in ms (default: 30000)
export MEMOCLAW_MAX_RETRIES=3                 # retries for transient failures (default: 3)
export MEMOCLAW_CONCURRENCY=10                # concurrency for bulk operations (default: 10)
export MEMOCLAW_HTTP_TOKEN=mysecrettoken       # bearer token for HTTP transport auth (optional)

克劳德桌面版

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

{
  "mcpServers": {
    "memoclaw": {
      "command": "memoclaw-mcp",
      "env": {
        "MEMOCLAW_PRIVATE_KEY": "0x..."
      }
    }
  }
}

光标

在光标首选项中添加到MCP设置。

可流式HTTP传输

默认情况下，服务器使用stdio传输。要作为HTTP服务器运行（MCP规范2025-03-26可流式HTTP）：

# Via CLI flag
memoclaw-mcp --http

# Via environment variable
MEMOCLAW_TRANSPORT=http memoclaw-mcp

# Custom port (default: 3100)
MEMOCLAW_PORT=8080 memoclaw-mcp --http

服务器公开：

  • POST /mcp --MCP可流式HTTP端点
  • GET /health --健康检查返回 { status: "ok", version: "..." }

配置您的MCP客户端以连接到 http://localhost:3100/mcp.

速率限制

HTTP传输包括内置的速率限制，以防止滥用：

环境变量 默认值 描述
MEMOCLAW_RATE_LIMIT 60 每个窗口每个IP的最大请求数
MEMOCLAW_GLOBAL_RATE_LIMIT 200 每个窗口的最大总请求数
MEMOCLAW_SESSION_RATE_LIMIT 10 每个窗口每个IP的最大新会话数
MEMOCLAW_RATE_LIMIT_WINDOW_MS 60000 窗口持续时间（毫秒）（1分钟）
MEMOCLAW_TRUST_PROXY false 信任 X-Forwarded-For 客户端IP的标头（设置为 true 或 1 当位于反向代理之后时）

将任何限制设置为 0 禁用它。速率受限的请求会收到 429 Too Many Requests 响应a Retry-After 头球

工具

核心

工具 说明
memoclaw_store 使用语义嵌入存储内存
memoclaw_recall 语义搜索——通过意义找到记忆
memoclaw_search 关键字搜索——按精确文本查找记忆
memoclaw_get 按ID获取单个内存
memoclaw_list 按时间顺序列出记忆
memoclaw_delete 按ID删除内存
memoclaw_update 更新内存字段
memoclaw_context 使用GPT-4o-mini获取上下文相关的记忆

批量操作

工具 说明
memoclaw_bulk_store 一次通话最多可储存100段回忆
memoclaw_bulk_delete 一次通话最多可删除100个记忆
memoclaw_batch_update 一次通话最多可更新50个记忆
memoclaw_import 从JSON数组导入内存
memoclaw_export 将所有内存导出为JSON或JSONL

摄入和提取

工具 说明
memoclaw_ingest 转储对话/文本，自动提取带有数据和关系的事实
memoclaw_extract 通过LLM从对话中提取结构化事实
memoclaw_consolidate 通过聚类合并相似/重复的记忆
memoclaw_migrate 将.md/.txt文件批量导入MemoClaw

组织

工具 说明
memoclaw_pin 固定内存以防止衰减
memoclaw_unpin 打开内存
memoclaw_tags 列出所有具有计数的唯一标签
memoclaw_namespaces 列出所有具有计数的命名空间
memoclaw_count 计数内存（带可选过滤器）
memoclaw_delete_namespace 删除命名空间中的所有内存

知识图谱

工具 说明
memoclaw_create_relation 在两段记忆之间建立联系
memoclaw_list_relations 列出内存的关系
memoclaw_delete_relation 删除关系
memoclaw_graph 从起始内存遍历内存图

见解和状态

工具 说明
memoclaw_suggested 获得积极的建议（陈旧、新鲜、热门、腐烂）
memoclaw_core_memories 获取您最重要/最常访问的记忆
memoclaw_stats 内存使用统计
memoclaw_history 查看内存的编辑历史记录
memoclaw_check_duplicates 存储前检查是否存在类似内容
memoclaw_status 查看免费套餐剩余通话
memoclaw_init 验证配置和API连接

示例用法

配置后，您的AI代理可以：

  • 请记住，会议将于明天下午3点召开
  • “关于项目截止日期，我说了什么？”
  • “让我看看我的核心记忆”
  • “整合重复的内存（先进行模拟运行）”

定价

免费等级： 每个钱包都得到 100个免费API调用 --无需付款。

免费等级后，x402小额支付将自动生效：

付费（使用嵌入）：

操作 价格
商店 0.005美元
存储批次（最多100个） $0.04
回忆（语义搜索） $0.005
更新（内容更改） $0.005
批量更新 0.005美元

付费（使用GPT-4o-mini+嵌入）：

操作 价格
提取/摄入 0.01美元
合并 0.01美元
背景 0.01美元
迁移 0.01美元

免费（无OpenAI费用）： 列表、获取、删除、批量删除、搜索（文本）、建议、核心内存、关系、历史记录、导出、命名空间、统计信息、标签、固定/取消固定、计数、状态、初始化。

链接

  • 网站：https://memoclaw.com
  • 文件：https://docs.memoclaw.com
  • APIhttps://api.memoclaw.com
  • CLI： npm install -g memoclaw

许可证

麻省理工学院

相关 MCP