MemoClaw MCP服务器
 ](https://www.npmjs.com/package/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
许可证
麻省理工学院
