@mixmediahk/mm-memory-mcp

Agent 記憶系統 MCP Server。讓你的 AI 程式助手讀寫長期記憶。

MCP Client 配置

Claude Code

claude mcp add --transport stdio memory \
  --env MEMORY_API_URL=http://localhost:8080 \
  --env MEMBER_TOKEN=mt_xxx \
  -- npx -y @mixmediahk/mm-memory-mcp

或建立 .mcp.json 於專案目錄：

{
 "mcpServers": {
   "memory": {
     "command": "npx",
     "args": ["-y", "@mixmediahk/mm-memory-mcp"],
     "env": {
       "MEMORY_API_URL": "http://localhost:8080",
       "MEMBER_TOKEN": "mt_xxx"
     }
   }
 }
}

Codex (OpenAI)

codex mcp add memory \
  --command npx --args -y @mixmediahk/mm-memory-mcp \
  --env MEMORY_API_URL=http://localhost:8080 \
  --env MEMBER_TOKEN=mt_xxx

或編輯 ~/.codex/config.toml：

[mcp_servers.memory]
command = "npx"
args = ["-y", "@mixmediahk/mm-memory-mcp"]

[mcp_servers.memory.env]
MEMORY_API_URL = "http://localhost:8080"
MEMBER_TOKEN = "mt_xxx"

opencode

編輯 opencode.jsonc：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "memory": {
      "type": "local",
      "command": ["npx", "-y", "@mixmediahk/mm-memory-mcp"],
      "enabled": true,
      "environment": {
        "MEMORY_API_URL": "http://localhost:8080",
        "MEMBER_TOKEN": "mt_xxx"
      }
    }
  }
}

環境變數

| 變數 | 預設值 | 說明 | |------|--------|------| | MEMORY_API_URL | http://localhost:8080 | mm-memory API 服務位址 | | MEMBER_TOKEN | - | Member Token（mt_... 格式，從 Web UI 取得，優先使用） | | PROJECT_TOKEN | - | Project Token（pt_... 格式，備用，僅限單一 project 存取） | | LOG_LEVEL | info | 日誌級別：silent、error、warn、info、debug |

認證優先順序：MEMBER_TOKEN > PROJECT_TOKEN。兩者皆未設定時以匿名模式運行（僅限 public project）。

取得 Token

| Token 類型 | 格式 | 取得方式 | |-----------|------|----------| | Member Token | mt_<32 hex> | Web UI 登入後複製，或透過 POST /api/v1/member/token/reset | | Project Token | pt_<32 hex> | Project owner 從 Web UI 或 POST /api/v1/projects/{id}/token 生成 |

認證模式與工具權限

MCP Server 根據 Token 類型調整可用工具：

| Tool | Member Token | Project Token | 匿名模式 | |------|:-----------:|:-------------:|:---------:| | create_memory | ✅ | ✅ | ✅ | | get_memory | ✅ | ✅ | ✅ | | update_memory | ✅ | ✅ | ✅ | | delete_memory | ✅ | ✅ | ✅ | | search_memories | ✅ | ✅ | ✅ | | list_memories | ✅ | ✅ | ✅ | | batch_create_memories | ✅ | ✅ | ✅ | | batch_update_memories | ✅ | ✅ | ✅ | | batch_delete_memories | ✅ | ✅ | ✅ | | get_task_status | ✅ | ✅ | ✅ | | list_projects | ✅（自己 + 他人 public） | ✅（限當前 project） | ✅（所有 public） | | create_project | ✅ | ❌ | ✅ | | get_project | ✅ | ✅ | ✅ | | update_project | ✅（owner only） | ❌ | ✅ | | delete_project | ✅（owner only） | ❌ | ✅ | | health_check | ✅ | ✅ | ✅ |

MCP Tools

Memory

| Tool | 說明 | |------|------| | create_memory | 建立記憶（fact / event / preference / context） | | get_memory | 取得單筆記憶 | | update_memory | 更新記憶內容 | | delete_memory | 刪除記憶 | | search_memories | 混合搜尋（關鍵字 + 語意） | | list_memories | 分頁列出記憶 |

Batch Operations

| Tool | 說明 | |------|------| | batch_create_memories | 批量建立記憶（非同步，返回 task_uid） | | batch_update_memories | 批量更新記憶（非同步，返回 task_uid） | | batch_delete_memories | 批量刪除記憶（非同步，返回 task_uid） | | get_task_status | 查詢批量任務狀態（enqueued → processing → succeeded / failed） |

批量操作上限：單次最多 100 筆、請求體最大 1MB。返回 task_uid 後需用 get_task_status 輪詢完成狀態。

Project

| Tool | 說明 | |------|------| | list_projects | 列出所有 Project | | create_project | 建立 Project | | get_project | 取得單筆 Project | | update_project | 更新 Project | | delete_project | 刪除 Project（級連刪除記憶） |

系統

| Tool | 說明 | |------|------| | health_check | 檢查 API 健康狀態 |

本機開發

yarn install          # 安裝相依套件
yarn build            # 編譯
yarn start            # 啟動 MCP Server
yarn test:inspector   # MCP Inspector 測試

發布流程

# 確認版本
yarn version:patch   # 1.0.0 -> 1.0.1

# 編譯並測試發布
yarn build
yarn publish:dry     # 檢查將發布的內容

# 正式發布
yarn publish