Memstate AI MCP Server

Memstate AI - MCP

Bộ nhớ có phiên bản dành cho tác nhân AI. Lưu trữ sự kiện, phát hiện xung đột và theo dõi cách các quyết định thay đổi theo thời gian — được cung cấp dưới dạng máy chủ MCP lưu trữ.

Dashboard · Tài liệu · Giá cả

---

Tại sao chọn Memstate?

	RAG (hầu hết các hệ thống bộ nhớ khác)	Memstate AI
Token sử dụng mỗi cuộc trò chuyện	~7.500	~1.500
Khả năng hiển thị của tác nhân	Hộp đen	Minh bạch hoàn toàn
Phiên bản bộ nhớ	Không có	Lịch sử đầy đủ
Tăng trưởng token khi bộ nhớ mở rộng	O(n)	O(1)
Cần cơ sở hạ tầng	Có	Không — SaaS lưu trữ

Các hệ thống bộ nhớ khác đổ mọi thứ vào cửa sổ ngữ cảnh của bạn và hy vọng điều tốt nhất. Memstate cung cấp cho tác nhân của bạn một cơ sở tri thức có cấu trúc và phiên bản mà nó điều hướng chính xác — chỉ tải những gì bạn cần, biết điều gì đã thay đổi, biết khi nào sự kiện xung đột.

---

Điểm chuẩn

Chúng tôi đã xây dựng một bộ điểm chuẩn mã nguồn mở kiểm tra những gì thực sự quan trọng đối với bộ nhớ tác nhân: hệ thống của bạn có thể lưu trữ sự kiện, nhớ lại chính xác qua các phiên, phát hiện xung đột khi mọi thứ thay đổi và duy trì ngữ cảnh khi dự án phát triển không?

Đối đầu trực tiếp: Memstate AI vs Mem0

Cả hai hệ thống được kiểm tra trong điều kiện giống hệt nhau sử dụng cùng một tác nhân (Claude Sonnet 4.6, temperature 0), cùng các kịch bản và cùng thang điểm đánh giá.

Chỉ số	Memstate AI	Mem0	Bên thắng
Điểm tổng thể	69.1	15.4	Memstate
Độ chính xác (nhớ lại sự kiện)	74.1	12.6	Memstate
Phát hiện xung đột	85.5	19.0	Memstate
Tính liên tục ngữ cảnh	63.7	10.1	Memstate
Hiệu quả token	22.3	30.6	Mem0

Trọng số chấm điểm: Độ chính xác 40%, Phát hiện xung đột 25%, Tính liên tục ngữ cảnh 25%, Hiệu quả token 10%.

Phân tích theo từng kịch bản

Điểm chuẩn chạy năm kịch bản thực tế mô phỏng quy trình làm việc của tác nhân đa phiên:

Kịch bản	Memstate AI	Mem0
Tiến hóa kiến trúc ứng dụng web	43.2	55.6
Di chuyển hệ thống xác thực	66.2	10.2
Tiến hóa lược đồ cơ sở dữ liệu	72.7	7.0
Xung đột phiên bản API	86.5	0.9
Đảo ngược quyết định nhóm	77.2	3.3

Mem0 thắng kịch bản đầu tiên (theo dõi kiến trúc đơn giản), nhưng gặp khó khăn nghiêm trọng trong các kịch bản yêu cầu xử lý mâu thuẫn, ngữ cảnh xuyên phiên và theo dõi đảo ngược quyết định — ghi điểm gần bằng không ở ba trong năm kịch bản.

Tại sao Memstate thắng

Điểm chuẩn tiết lộ một sự khác biệt kiến trúc cơ bản:

Mem0 sử dụng tìm kiếm ngữ nghĩa dựa trên embedding. Sự kiện được phân đoạn, nhúng và truy xuất theo độ tương đồng. Điều này hoạt động cho các tra cứu đơn giản nhưng hỏng khi:

• Sự kiện mâu thuẫn với sự kiện trước đó (hệ thống không thể phân biệt hiện tại và lỗi thời)
• Cần nhớ lại chính xác (embedding trả về kết quả "tương tự", không phải chính xác)
• Độ trễ ghi-đọc quan trọng (ký ức mới mất vài giây để có thể tìm kiếm)

Memstate sử dụng lưu trữ khóa-giá trị có cấu trúc và phiên bản. Mỗi sự kiện nằm tại một keypath rõ ràng với lịch sử phiên bản đầy đủ. Điều này có nghĩa là:

• Phát hiện xung đột được tích hợp sẵn — khi một sự kiện mới mâu thuẫn với sự kiện cũ, hệ thống biết và bảo tồn cả hai phiên bản
• Nhớ lại là xác định — bạn nhận lại chính xác những gì đã lưu trữ, không phải một kết quả xấp xỉ
• Tính liên tục xuyên phiên là đáng tin cậy — tác nhân điều hướng một cây có cấu trúc thay vì hy vọng tìm kiếm ngữ nghĩa hiển thị đúng ngữ cảnh
• Chi phí token giữ ở mức O(1) — tác nhân tải tóm tắt trước và đào sâu chi tiết chỉ khi cần, thay vì đổ tất cả embedding có khả năng liên quan vào cửa sổ ngữ cảnh

Ghi chú về tính công bằng

• Cả hai hệ thống sử dụng cùng mô hình tác nhân, temperature và thang đánh giá
• Mem0 được cho độ trễ nhập 10 giây giữa ghi và đọc để tính đến pipeline nhúng bất đồng bộ của nó
• Mem0 ghi điểm cao hơn về hiệu quả token, nhưng chỉ số này nên được đọc trong ngữ cảnh — sử dụng token thấp hơn có thể đơn giản phản ánh ít thông tin được trả về hơn. Một hệ thống truy xuất sự kiện không đầy đủ hoặc không chính xác sử dụng ít token hơn mỗi phản hồi nhưng có thể yêu cầu nhiều cuộc gọi tiếp theo hơn, cuối cùng tốn nhiều token hơn để đạt được cùng một câu trả lời
• Mã nguồn điểm chuẩn được bao gồm trong kho lưu trữ này để tái tạo đầy đủ
• Mem0 có thể hoạt động khác với cấu hình tùy chỉnh hoặc mô hình nhúng khác

---

Bắt đầu nhanh

Lấy khóa API của bạn tại memstate.ai/dashboard, sau đó thêm vào cấu hình máy khách MCP của bạn:

{
  "mcpServers": {
    "memstate": {
      "command": "npx",
      "args": ["-y", "@memstate/mcp"],
      "env": {
        "MEMSTATE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Không Docker. Không cơ sở dữ liệu. Không cơ sở hạ tầng. Chạy trong 60 giây.

---

Thiết lập máy khách

Claude Desktop

Vị trí cấu hình:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memstate": {
      "command": "npx",
      "args": ["-y", "@memstate/mcp"],
      "env": { "MEMSTATE_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

Claude Code

claude mcp add memstate npx @memstate/mcp -e MEMSTATE_API_KEY=YOUR_API_KEY_HERE

Cursor

Trong Cursor Settings → MCP → Add Server — cùng định dạng JSON như Claude Desktop ở trên.

Cline / Windsurf / Kilo Code / Roo Code

Tất cả hỗ trợ cùng định dạng cấu hình MCP stdio. Thêm vào tệp cài đặt MCP của máy khách của bạn.

---

Công cụ cốt lõi

Công cụ	Khi nào sử dụng
memstate_remember	Lưu trữ markdown, tóm tắt nhiệm vụ, quyết định. Máy chủ tự động trích xuất keypath và phát hiện xung đột. Sử dụng cho hầu hết các lần ghi.
memstate_set	Đặt một keypath đơn thành một giá trị ngắn (ví dụ: config.port = 8080). Không dành cho văn xuôi.
memstate_get	Duyệt tất cả ký ức cho một dự án hoặc cây con. Sử dụng khi bắt đầu mỗi nhiệm vụ.
memstate_search	Tìm kiếm ngữ nghĩa theo ý nghĩa khi bạn không biết keypath chính xác.
memstate_history	Xem cách một phần kiến thức thay đổi theo thời gian — chuỗi phiên bản đầy đủ.
memstate_delete	Xóa mềm một keypath. Tạo một bia mộ; lịch sử đầy đủ được bảo tồn.
memstate_delete_project	Xóa mềm toàn bộ dự án và tất cả ký ức của nó.

Cách keypath hoạt động

Ký ức được tổ chức theo ký hiệu dấu chấm phân cấp:

project.my_app.database.schema
project.my_app.auth.provider
project.my_app.deploy.environment

Keypath được tự động thêm tiền tố: keypath="database" với project_id="my_app" → project.my_app.database. Tác nhân của bạn có thể đào sâu vào chính xác những gì nó cần — không đổ toàn bộ ngữ cảnh.

---

Cách nó hoạt động

Agent: memstate_remember(project_id="my_app", content="## Auth\nUsing SuperTokens...")
         ↓
Server extracts keypaths:  [project.my_app.auth.provider, ...]
         ↓
Conflict detection:  compare against existing memories at those keypaths
         ↓
New version stored — old version preserved in history chain
         ↓
Next session: memstate_get(project_id="my_app") → structured summaries only
         ↓
Agent drills into project.my_app.auth only when it needs auth details

Chi phí token giữ không đổi bất kể tổng số ký ức tồn tại.

---

Thêm vào hướng dẫn tác nhân của bạn

Sao chép vào AGENTS.md hoặc system prompt của bạn:

## Memory (Memstate MCP)

### Before each task
- memstate_get(project_id="my_project") — browse existing knowledge
- memstate_search(query="topic", project_id="my_project") — find by meaning

### After each task
- memstate_remember(project_id="my_project", content="## Summary\n- ...", source="agent")

### Tool guide
- memstate_remember — markdown summaries, decisions, task results (preferred)
- memstate_set — single short values only (config flags, status)
- memstate_get — browse/retrieve before tasks
- memstate_search — semantic lookup when keypath unknown
- memstate_history — audit how knowledge evolved
- memstate_delete — remove outdated memories (history preserved)

---

Biến môi trường

Biến	Mặc định	Mô tả
MEMSTATE_API_KEY	(bắt buộc)	Khóa API từ memstate.ai/dashboard
MEMSTATE_MCP_URL	https://mcp.memstate.ai	Ghi đè cho triển khai tự lưu trữ

Xác minh kết nối của bạn

MEMSTATE_API_KEY=your_key npx @memstate/mcp --test

In tất cả các công cụ có sẵn và xác nhận khóa API của bạn hoạt động.

Được xây dựng cho các tác nhân AI xứng đáng biết những gì chúng biết.