🧠 MemoryAPI

为 AI 智能体和 LLM 提供持久化记忆 — REST API + MCP 原生支持

License: MIT MCP Compatible

MemoryAPI 为您的 AI 智能体提供跨会话的持久化、可搜索记忆。以自然语言存储记忆，并进行语义检索 — 无需精确关键词。

🌐 memoryapi.org | 📡 API: api.memoryapi.org

功能特性

🧠 语义搜索 — 按含义而非关键词查找记忆
🔌 MCP 原生 — 即插即用，支持 Claude、Cursor、Windsurf 等
⚡ REST API — 简单的 HTTP 端点，适用于任何编程语言
🔑 API 密钥认证 — 安全，按智能体命名空间隔离
📊 使用追踪 — 记忆计数和套餐限额
🌍 始终在线 — 托管于 api.memoryapi.org

快速开始

1. 获取 API 密钥

curl -X POST https://api.memoryapi.org/keys \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "my-agent", "email": "you@example.com"}'

{
  "api_key": "mem_xxxxxxxx.yyyyyyyy",
  "message": "Save this key securely — it will not be shown again."
}

2. 存储记忆

curl -X POST https://api.memoryapi.org/memory \
  -H "Content-Type: application/json" \
  -H "x-api-key: mem_xxxxxxxx.yyyyyyyy" \
  -d '{"content": "User prefers dark mode and React Native"}'

3. 搜索记忆

curl "https://api.memoryapi.org/memory?query=what+does+the+user+prefer" \
  -H "x-api-key: mem_xxxxxxxx.yyyyyyyy"

MCP 集成

添加到您的 MCP 客户端配置中（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "memoryapi": {
      "url": "https://api.memoryapi.org/mcp",
      "headers": {
        "x-api-key": "mem_xxxxxxxx.yyyyyyyy"
      }
    }
  }
}

可用 MCP 工具

工具	描述
`store_memory`	以自然语言存储记忆
`search_memory`	对记忆进行语义搜索
`list_memories`	列出所有已存储的记忆
`delete_memory`	按 ID 删除记忆

REST API 参考

`POST /memory`

存储一条记忆。

请求头： x-api-key: your-key

请求体：

{
  "content": "string (required, max 10,000 chars)",
  "metadata": { "type": "preference" }
}

`GET /memory?query=...`

对记忆进行语义搜索。

请求头： x-api-key: your-key

查询参数：

query (必填) — 自然语言搜索内容
limit (可选，默认 10) — 最大结果数
threshold (可选，默认 0.4) — 相似度阈值

`GET /memory/list`

列出该智能体的所有记忆。

查询参数：

limit (默认 50)
offset (默认 0)

`DELETE /memory/:id`

删除特定记忆。

`POST /keys`

生成新的 API 密钥。