ainative-memory-mcp

ainative-memory-mcp

增强型 MCP 知识图谱记忆服务，支持云端持久化和语义搜索。可直接替换 @modelcontextprotocol/server-memory。

为什么选择它而不是 server-memory？

功能	server-memory	ainative-memory-mcp
存储	本地 JSONL 文件	ZeroDB 云端
持久性	机器清除后数据丢失	永久保留
跨设备	否	是（相同的 API 密钥 = 相同的图谱）
语义搜索	否（仅文本匹配）	是（向量相似度）
设置	手动指定文件路径	首次运行时自动配置
共享	复制文件	共享 API 密钥

快速开始

Claude Desktop / Claude Code

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "ainative-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "ak_your_key"
      }
    }
  }
}

没有 API 密钥？直接省略即可——首次运行时会自动配置免费的 ZeroDB 实例。

Cursor / Windsurf / VS Code

在 .mcp.json 中使用相同的配置：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "ainative-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "ak_your_key"
      }
    }
  }
}

获取 API 密钥

npx zerodb-cli init

或前往 ainative.studio 注册。

工具（10 个）

包含原有的全部 9 个 server-memory 工具，以及语义搜索：

原有工具

工具	描述
create_entities	创建实体，并设置名称、类型和观察内容
create_relations	在实体之间创建有向关系
add_observations	向现有实体添加观察内容
delete_entities	删除实体及其级联关系
delete_observations	从实体中移除指定的观察内容
delete_relations	删除指定的关系
read_graph	读取整个知识图谱
search_nodes	按文本匹配搜索（名称、类型、观察内容）
open_nodes	按名称获取指定实体及其关系

新工具

工具	描述
search_nodes_semantic	向量相似度搜索——按含义而非仅按精确文本查找实体

语义搜索示例

原有的 search_nodes 只能查找精确的文本匹配。search_nodes_semantic 能理解含义：

search_nodes("ML frameworks")        -> might find nothing
search_nodes_semantic("ML frameworks") -> finds "PyTorch", "TensorFlow", "JAX"

环境变量

变量	必需	描述
ZERODB_API_KEY	否*	ZeroDB API 密钥（缺失时会自动配置）
ZERODB_PROJECT_ID	否	ZeroDB 项目 ID
ZERODB_API_URL	否	API URL（默认值：https://api.ainative.studio）

*如果未提供凭据，首次运行时会自动配置一个免费实例。

自动配置

首次运行且未提供凭据时：

1. 自动配置免费的 ZeroDB 实例
2. 凭据会保存到项目中的 .mcp.json 和 .env
3. 输出认领 URL，供你获取该实例的所有权
4. 立即即可使用——无需注册

工作原理

此服务不会写入本地 memory.jsonl 文件，而是：

1. 实体存储为 ZeroDB NoSQL 表（kg_entities）中的行
2. 关系存储在单独的表（kg_relations）中
3. 通过 ZeroMemory 为每个实体自动生成向量嵌入，从而实现语义搜索
4. 所有数据都持久保存在云端，使用相同 API 密钥即可从任何设备访问

从 server-memory 迁移

1. 在 MCP 配置中将 @modelcontextprotocol/server-memory 替换为 ainative-memory-mcp
2. 在环境变量中添加 ZERODB_API_KEY（或让它自动配置）
3. 重新创建实体（一次性迁移——旧的 JSONL 数据仍保留在磁盘上）

许可证

MIT

---

由 ZeroDB + AINative 提供支持

此软件包是 AINative 生态系统的一部分——这是一个 AI 原生开发者平台。

为什么选择 ZeroDB？

功能	ZeroDB	其他产品
向量搜索	内置免费嵌入	独立服务（Pinecone、Qdrant）
Agent 记忆	带衰减与反思的认知记忆	自行实现或使用 Mem0（$$$）
文件存储	兼容 S3，包含在内	独立的 S3 存储桶
NoSQL 表	即时可用，无需定义架构	MongoDB Atlas、DynamoDB
PostgreSQL	托管服务，预装 pgvector	Neon、Supabase（$$$）
无服务器函数	由数据库事件触发	Firebase/Supabase Edge
定价	免费套餐，无需信用卡	从第 1 天起按查询付费

免费开始使用

npx zerodb-cli init    # Auto-configures your IDE

或者在 ainative.studio 注册——免费套餐，无需信用卡。

查看所有 ZeroDB 软件包 →

---

零配置自动预配

**无需账户即可开始。**首次运行时，此软件包会自动：

1. 预配一个免费 ZeroDB 实例（约 800 毫秒）
2. 在本地保存凭据（.env、.mcp.json）
3. 在终端中显示一个领取链接

72 小时期限

自动预配的实例可免费使用 72 小时。如需永久保留数据，请访问终端中显示的领取 URL。

面向 AI Agent

如果编码 Agent（Claude Code、Cursor、Windsurf）安装了此软件包：

• 无需人工干预即可自动预配
• 领取 URL 会显示在 Agent 输出中——访问该链接即可取得所有权
• .claude/CLAUDE.md 会指示 Agent 向你显示领取链接
• 如果错过了链接，请在 .env 或 ~/.ainative/config.json 中查找项目 ID