Engram MCP Server

chính thức

Engram là một máy chủ MCP được lưu trữ, cung cấp bộ nhớ đáng tin cậy cho các tác nhân AI:

Tài liệu

Engram MCP

Trao cho tác nhân AI của bạn một bộ nhớ mà chúng có thể tin cậy. Engram cho phép AI của bạn ghi nhớ các cuộc trò chuyện, sự kiện và quyết định trong quá khứ, nhờ đó nó trở nên giống một đồng đội thực thụ hơn.

Kho lưu trữ này chứa các mẫu cấu hình để kết nối các máy khách MCP với Engram, một dịch vụ bộ nhớ được lưu trữ dành cho tác nhân AI.

Engram là gì?

Engram là một máy chủ MCP được lưu trữ cung cấp bộ nhớ đáng tin cậy và có thể giải thích cho các tác nhân AI:

Bộ nhớ đáng tin cậy: Tác nhân ghi nhớ các cuộc trò chuyện, sự kiện và quyết định, với khả năng trích xuất đồ thị tri thức tự động
Truy xuất có thể giải thích: Mỗi câu trả lời đều trích dẫn các ký ức và cạnh đồ thị đã chứng minh cho câu trả lời đó
Truy xuất ba công cụ: BM25 + tìm kiếm vector + đồ thị tri thức, được hợp nhất và xếp hạng lại
Mang theo mô hình của riêng bạn: Tất cả các lệnh gọi LLM đều được định tuyến qua nhà cung cấp của bạn — không có phụ phí suy luận
Kiểm soát tích hợp sẵn: Sắp xếp ký ức vào các nhóm, quản lý thời gian lưu trữ và truy vấn bằng ngôn ngữ tự nhiên

Gói miễn phí: 10K ký ức được lưu trữ và 50K lượt truy xuất mỗi tháng — không yêu cầu thẻ tín dụng. Xem bảng giá cho các gói trả phí.

Thiết lập nhanh

1. Lấy khóa API của bạn

Đăng ký tại lumetra.io để tạo tài khoản và tạo khóa API.

Một số máy khách (Claude.ai web, ChatGPT) sử dụng OAuth thay vì dán khóa — xem các phần tương ứng bên dưới.

2. Thêm Engram vào máy khách MCP của bạn

Điểm cuối MCP: https://mcp.lumetra.io/mcp/sse

Claude Code

claude mcp add-json engram '{"type":"sse","url":"https://mcp.lumetra.io/mcp/sse","headers":{"Authorization":"Bearer <your-api-key>"}}'

Claude.ai web (OAuth — không cần dán khóa)

Trong cài đặt Claude → Connectors → Thêm trình kết nối tùy chỉnh, dán:

https://mcp.lumetra.io/mcp/sse

Bạn sẽ được chuyển hướng qua Lumetra để ủy quyền kết nối. Không yêu cầu khóa API.

ChatGPT web (OAuth — Các gói có khả năng kết nối)

Trong cài đặt ChatGPT → Thêm trình kết nối MCP tùy chỉnh, dán:

https://mcp.lumetra.io/mcp/sse

Quy trình OAuth tương tự như Claude.ai.

Cursor

~/.cursor/mcp.json hoặc .cursor/mcp.json:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.lumetra.io/mcp/sse",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.lumetra.io/mcp/sse",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Windsurf chấp nhận cả url và serverUrl cho các máy chủ MCP từ xa. Chúng tôi sử dụng url ở đây để phù hợp với các máy khách khác trên trang này.

OpenCode

opencode.json:

{
  "mcpServers": {
    "engram": {
      "url": "https://mcp.lumetra.io/mcp/sse",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

OpenClaw

Khi kỹ năng này có mặt trên ClawHub:

openclaw skill add lumetra-engram
# or
clawhub install lumetra-engram

Hiện tại, hãy cài đặt thủ công từ lumetra-io/engram-openclaw-skill:

mkdir -p .openclaw/skills
curl -fsSL https://codeload.github.com/lumetra-io/engram-openclaw-skill/tar.gz/refs/heads/main \
  | tar -xz --strip-components=2 -C .openclaw/skills engram-openclaw-skill-main/skills/engram
export ENGRAM_API_KEY="eng_live_..."

3. Khởi động lại máy khách của bạn

Máy khách MCP của bạn bây giờ sẽ có quyền truy cập vào các công cụ bộ nhớ Engram.

Các công cụ có sẵn

Sau khi kết nối, tác nhân của bạn có các công cụ bộ nhớ sau:

Công cụ	Mô tả
`store_memory(content, bucket?)`	Lưu trữ một sự kiện hoặc một mẩu thông tin (mặc định vào nhóm `"default"`)
`query_memory(question, bucket?)`	Tìm kiếm ký ức bằng ngôn ngữ tự nhiên, với tổng hợp AI và giải thích cho từng ký ức
`list_memories(bucket, limit?)`	Liệt kê các ký ức trong một nhóm, mới nhất trước (`limit` 1–100, mặc định 20)
`list_buckets()`	Liệt kê các nhóm bộ nhớ có sẵn
`delete_memory(memory_id, bucket)`	Xóa một ký ức cụ thể theo ID
`clear_memories(bucket)`	Xóa tất cả ký ức trong một nhóm (có tính hủy diệt!)

Hợp nhất truy vấn đa nhóm (truyền nhiều nhóm trong một lệnh gọi) có sẵn trên điểm cuối REST /v1/query và trong các SDK chính thức. Công cụ MCP query_memory hiện chỉ chấp nhận một nhóm cho mỗi lệnh gọi.

Lời nhắc tác nhân được khuyến nghị

Thêm nội dung này vào lời nhắc hệ thống của tác nhân để khuyến khích sử dụng bộ nhớ hiệu quả:

You have Engram Memory. Use it proactively to improve continuity and personalization.

Tools:
- store_memory(content, bucket?) - Store a fact or piece of information
- query_memory(question, bucket?) - Search memories using natural language
- list_memories(bucket, limit?) - List memories in a bucket, newest first
- list_buckets() - List available memory buckets
- delete_memory(memory_id, bucket) - Delete a specific memory
- clear_memories(bucket) - Clear all memories in a bucket (destructive!)

Policy:
- Query-first: before answering anything that may rely on prior context, call query_memory. Ground your answers in the results.
- Proactive storing: capture stable preferences, profile facts, project details, decisions, and outcomes. Keep each fact concise (1-2 sentences).
- Use buckets: organize memories by project or context (e.g., "work", "personal", "project-alpha").

Style for stored content: short, declarative, atomic facts.
Examples:
- "User prefers dark mode."
- "User timezone is US/Eastern."
- "Project Alpha deadline is 2026-10-15."

REST API

Engram cũng cung cấp REST API để truy cập theo chương trình từ bất kỳ máy khách HTTP nào (Vercel AI SDK, LangChain, LlamaIndex, Mastra, CrewAI, AutoGen, n8n, các tập lệnh của riêng bạn).

URL cơ sở: https://api.lumetra.io

Xác thực: Bao gồm khóa API của bạn trong tiêu đề Authorization:

curl -X POST https://api.lumetra.io/v1/buckets/default/memories \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Alice works at TechCorp"}'

Ví dụ nhanh:

# Store a memory
curl -X POST https://api.lumetra.io/v1/buckets/work/memories \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Bob is the CEO of Acme Inc"}'

# Query your memories
curl -X POST https://api.lumetra.io/v1/query \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Who is the CEO of Acme?", "buckets": ["work"]}'

Xem tài liệu API đầy đủ để biết tất cả các điểm cuối có sẵn.

Các trường hợp sử dụng

Các nhóm sử dụng Engram cho:

Hỗ trợ với ngữ cảnh trước đó: Mang theo ticket cuối cùng, môi trường, kế hoạch và các theo dõi đã hứa
Đánh giá mã với ngữ cảnh: Lưu trữ ADR, ghi chú của chủ sở hữu, các khu vực dễ hỏng và bài học kinh nghiệm dưới dạng ký ức
Định nghĩa chỉ số dùng chung: Giữ các định nghĩa, phép nối được phê duyệt và đoạn mã SQL ở một nơi
Nội dung nhất quán, đúng thương hiệu: Tập trung hóa giọng điệu và các tuyên bố đã được phê duyệt cho người viết

Về kho lưu trữ này

Kho lưu trữ này chứa:

README này với hướng dẫn thiết lập cho các máy khách MCP phổ biến
server.json — tệp kê khai máy chủ MCP tuân theo lược đồ chính thức

Tệp server.json sử dụng lược đồ máy chủ MCP chính thức và có thể được sử dụng bởi các máy khách MCP hỗ trợ khám phá máy chủ từ xa. Đối với cấu hình thủ công, hãy sử dụng các ví dụ cụ thể cho từng máy khách ở trên.

Dịch vụ Engram thực tế chạy tại https://mcp.lumetra.io (MCP) và https://api.lumetra.io (REST) — không yêu cầu cài đặt cục bộ.

Hỗ trợ

Trang sản phẩm: lumetra.io
Tài liệu: lumetra.io/docs
Bảng giá: lumetra.io/pricing
Liên hệ: [email protected]