🧠 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キーを生成します。

ボディ:

{
  "agent_id": "my-agent",
  "email": "you@example.com",
  "plan": "free"
}

料金プラン

プラン	価格	メモリ数	エージェント数
Free	$0/月	100	1
Starter	$19/月	10,000	5
Pro	$49/月	無制限	無制限

技術スタック

ランタイム: Node.js + Express
データベース: Supabase (PostgreSQL + pgvector)
埋め込み: OpenAI text-embedding-3-small
認証: bcryptハッシュ化APIキー
プロトコル: MCP 2024-11-05

MemoryAPI