Skip to main content

MCP Server for AI long-term memory and context management

Project description

MindCore Memory MCP

mcp-name: io.github.woshilaohei/mindcore-memory

AI Long-Term Memory Server — Production-grade persistent memory for AI agents.

"The best AI agent isn't the smartest — it's the one that remembers."

GitHub stars License: MIT Python 3.10+ woshilaohei/mindcore-memory-mcp MCP server

Value Proposition

MindCore Memory solves AI Agent's biggest pain point: limited context windows, lost information in long conversations, and broken cross-session memory continuity.

What Problem It Solves

Pain Point Status Quo MindCore Memory
AI forgets everything Conversation ends, all lost Persistent long-term memory
No cross-session recall Re-teach every session Cross-session knowledge reuse
Memory chaos, no priority All memories weighted equally Importance grading + confidence
RAG brute-force injection Context overload, quality drops Precise context window

Quick Start (3 lines)

# 1. Install
pip install mindcore-memory

# 2. Launch MCP Server
mindcore-memory

# 3. Call from your AI Agent
memory_id = memory_store("User says his name is Zhang San, free on Wednesday")
context = memory_recall("User's schedule")

Eval Framework Results

Storage Integrity:     100% (data persistence correct)
Recall Relevance:      100% (relevant memories recalled first)
Confidence Calibration: 100% (confidence correctly calibrated)
Importance Weighting:   100% (high-priority memories ranked higher)
Context Efficiency:    100% (context window not overloaded)

Overall Score: 100%

Core Tools

memory_store - Store memory

memory_store(
    content="Python was created by Guido van Rossum from Netherlands",
    importance=3,        # 1-4 importance level
    tags=["python", "history"],
    confidence=0.95,      # confidence score
    source="agent"       # agent/user/tool
)

memory_recall - Recall memory

memory_recall(
    query="Who created Python",
    tags=["python"],      # optional tag filter
    limit=10             # return count
)

memory_context - Build context window

# Build optimal context for current task (auto-dedup + priority sort)
context = memory_context(
    query="Current project status",
    max_tokens=2000      # auto-truncate
)

MCP Server Setup

Add to your MCP client configuration:

{
  "mcpServers": {
    "mindcore-memory": {
      "command": "python",
      "args": ["-m", "mindcore_memory.server"]
    }
  }
}

License

MIT License - Copyright (c) 2025 Lao Hei

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mindcore_memory-0.1.6.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mindcore_memory-0.1.6-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

Details for the file mindcore_memory-0.1.6.tar.gz.

File metadata

  • Download URL: mindcore_memory-0.1.6.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for mindcore_memory-0.1.6.tar.gz
Algorithm Hash digest
SHA256 43a19139961c579610302764a33dab7618725ba14c048f6d8f298d007eda9e1f
MD5 1c042f8cadbed9da52b2007d30032470
BLAKE2b-256 0be9a07564e3c1788a148a8755f9685c9145ec9625f7413db1fec34107794a9a

See more details on using hashes here.

File details

Details for the file mindcore_memory-0.1.6-py3-none-any.whl.

File metadata

File hashes

Hashes for mindcore_memory-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 365d6330e6e2df06772d3c160c75877f22921002b978eaf262ab1ea581ec0e11
MD5 b12f65bf3aff598d11114f62cee85d6d
BLAKE2b-256 93c2673497b39a76883b5a229dee9e3c4c2827e247d36244677534de22133926

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page