mindcore-memory 0.1.2__tar.gz → 0.1.4__tar.gz

mindcore_memory-0.1.4/.gitignore

@@ -0,0 +1,144 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Operating System Files
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Project specific
+storage/
+*.db
+*.db-shm
+*.db-wal
+models/
+logs/
+backups/

mindcore_memory-0.1.4/.pypirc

@@ -0,0 +1,8 @@
+[distutils]
+index-servers =
+    pypi
+
+[pypi]
+repository = https://upload.pypi.org/legacy/
+username = __token__
+password = pypi-AgEIcHlwaS5vcmcCJGJlZTNjMDBiLTc5MjctNGI4ZS04NTEyLWI5NTJiMzdmZmU2MQACKlszLCI3ZjBlYzA1MC1iNTk5LTQxNGQtYjY0NS04MzZkZTJlY2NhYTQiXQAABiAGDa-9DUpieFzHiMvnbqlzpU-cI3ZbfsSd-hkpX-D4Fw==

{mindcore_memory-0.1.2 → mindcore_memory-0.1.4}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 woshilaohei
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Lao Hei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mindcore_memory-0.1.4/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: mindcore-memory
+Version: 0.1.4
+Summary: MCP Server for AI long-term memory and context management
+Author-email: Lao Hei <1410770089@qq.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,context,llm,mcp,memory
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: json-rpc>=1.5.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: structlog>=24.0.0
+Requires-Dist: tinydb>=4.8.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.9.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# MindCore Memory MCP
+
+**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](https://img.shields.io/github/stars/woshilaohei/mindcore-memory-mcp?style=social)](https://github.com/woshilaohei/mindcore-memory-mcp/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
+[![woshilaohei/mindcore-memory-mcp MCP server](https://glama.ai/mcp/servers/woshilaohei/mindcore-memory-mcp/badges/score.svg)](https://glama.ai/mcp/servers/woshilaohei/mindcore-memory-mcp)
+
+## 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)
+
+```bash
+# 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
+```python
+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
+```python
+memory_recall(
+    query="Who created Python",
+    tags=["python"],      # optional tag filter
+    limit=10             # return count
+)
+```
+
+### `memory_context` - Build context window
+```python
+# Build optimal context for current task (auto-dedup + priority sort)
+context = memory_context(
+    query="Current project status",
+    max_tokens=2000      # auto-truncate
+)
+```
+
+### `memory_stats` - System status
+```python
+# View memory statistics: total/distribution/confidence
+stats = memory_stats()
+```
+
+## Project Structure
+
+```
+mindcore-memory-mcp/
+├── mindcore_memory/          # Python package (pip install entry)
+│   ├── __init__.py
+│   ├── memory_engine.py      # Core memory engine
+│   ├── server.py             # MCP Server (stdio + HTTP dual transport)
+│   ├── http_app.py           # HTTP endpoint (production deploy)
+│   └── eval_framework.py     # Evaluation framework
+├── tests/
+│   └── test_memory.py        # Unit tests
+├── examples/
+│   └── basic_usage.py        # Usage examples
+├── pyproject.toml
+├── README.md
+└── LICENSE
+```
+
+## Integration
+
+### Claude Desktop
+```json
+{
+  "mcpServers": {
+    "mindcore-memory": {
+      "command": "pip",
+      "args": ["install", "mindcore-memory"]
+    }
+  }
+}
+```
+
+### VS Code AI
+Search `MindCore Memory` in the extension marketplace.
+
+### HTTP API (Production)
+```bash
+curl -X POST http://localhost:8080/mcp \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"memory_store","arguments":{"content":"test"}},"id":1}'
+```
+
+## Production Standards
+
+| Standard | Implementation |
+|----------|---------------|
+| **JSON-RPC 2.0** | stdio + HTTP dual transport |
+| **Bearer Token Auth** | Optional auth for HTTP endpoints |
+| **Input Validation** | Pydantic schemas |
+| **CI/CD** | GitHub Actions |
+| **Unit Tests** | pytest + coverage |
+| **Eval Framework** | 5 core metrics |
+| **Observability** | structlog complete logging |
+| **Data Sovereignty** | JSONL local files, no vendor lock-in |
+
+## Open Source
+
+This project is open source (MIT License). The code is completely free. Storage uses local JSON files with no cloud service dependency and no data collection.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=woshilaohei/mindcore-memory-mcp&type=Timeline)](https://star-history.com/#woshilaohei/mindcore-memory-mcp&Timeline)
+
+---
+
+<p align="center">
+  <strong>Give AI memory. Make humans trust AI more.</strong>
+</p>
+
+---
+
+## Collaborate With Me
+
+I'm actively developing AI safety architecture projects including:
+
+1. **Cerebellum Evolution Engine** - AI safety & evolution framework
+2. **MindCore** - Cognitive memory architecture for AI systems
+3. **Border Guard** - Self-evolving security operating system
+4. **Ternary Balance Boundary Algorithm** - Novel equilibrium theory with 3 papers
+5. **MindCore Memory MCP** - This project: production-grade long-term memory server
+
+**Interested in collaborating?** Reach out:
+
+- Email: [1410770089@qq.com](mailto:1410770089@qq.com)
+- GitHub: [@woshilaohei](https://github.com/woshilaohei)
+
+**Author:** Lao Hei

mindcore_memory-0.1.4/README.md

@@ -0,0 +1,182 @@
+# MindCore Memory MCP
+
+**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](https://img.shields.io/github/stars/woshilaohei/mindcore-memory-mcp?style=social)](https://github.com/woshilaohei/mindcore-memory-mcp/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)
+[![woshilaohei/mindcore-memory-mcp MCP server](https://glama.ai/mcp/servers/woshilaohei/mindcore-memory-mcp/badges/score.svg)](https://glama.ai/mcp/servers/woshilaohei/mindcore-memory-mcp)
+
+## 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)
+
+```bash
+# 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
+```python
+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
+```python
+memory_recall(
+    query="Who created Python",
+    tags=["python"],      # optional tag filter
+    limit=10             # return count
+)
+```
+
+### `memory_context` - Build context window
+```python
+# Build optimal context for current task (auto-dedup + priority sort)
+context = memory_context(
+    query="Current project status",
+    max_tokens=2000      # auto-truncate
+)
+```
+
+### `memory_stats` - System status
+```python
+# View memory statistics: total/distribution/confidence
+stats = memory_stats()
+```
+
+## Project Structure
+
+```
+mindcore-memory-mcp/
+├── mindcore_memory/          # Python package (pip install entry)
+│   ├── __init__.py
+│   ├── memory_engine.py      # Core memory engine
+│   ├── server.py             # MCP Server (stdio + HTTP dual transport)
+│   ├── http_app.py           # HTTP endpoint (production deploy)
+│   └── eval_framework.py     # Evaluation framework
+├── tests/
+│   └── test_memory.py        # Unit tests
+├── examples/
+│   └── basic_usage.py        # Usage examples
+├── pyproject.toml
+├── README.md
+└── LICENSE
+```
+
+## Integration
+
+### Claude Desktop
+```json
+{
+  "mcpServers": {
+    "mindcore-memory": {
+      "command": "pip",
+      "args": ["install", "mindcore-memory"]
+    }
+  }
+}
+```
+
+### VS Code AI
+Search `MindCore Memory` in the extension marketplace.
+
+### HTTP API (Production)
+```bash
+curl -X POST http://localhost:8080/mcp \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_TOKEN" \
+  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"memory_store","arguments":{"content":"test"}},"id":1}'
+```
+
+## Production Standards
+
+| Standard | Implementation |
+|----------|---------------|
+| **JSON-RPC 2.0** | stdio + HTTP dual transport |
+| **Bearer Token Auth** | Optional auth for HTTP endpoints |
+| **Input Validation** | Pydantic schemas |
+| **CI/CD** | GitHub Actions |
+| **Unit Tests** | pytest + coverage |
+| **Eval Framework** | 5 core metrics |
+| **Observability** | structlog complete logging |
+| **Data Sovereignty** | JSONL local files, no vendor lock-in |
+
+## Open Source
+
+This project is open source (MIT License). The code is completely free. Storage uses local JSON files with no cloud service dependency and no data collection.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=woshilaohei/mindcore-memory-mcp&type=Timeline)](https://star-history.com/#woshilaohei/mindcore-memory-mcp&Timeline)
+
+---
+
+<p align="center">
+  <strong>Give AI memory. Make humans trust AI more.</strong>
+</p>
+
+---
+
+## Collaborate With Me
+
+I'm actively developing AI safety architecture projects including:
+
+1. **Cerebellum Evolution Engine** - AI safety & evolution framework
+2. **MindCore** - Cognitive memory architecture for AI systems
+3. **Border Guard** - Self-evolving security operating system
+4. **Ternary Balance Boundary Algorithm** - Novel equilibrium theory with 3 papers
+5. **MindCore Memory MCP** - This project: production-grade long-term memory server
+
+**Interested in collaborating?** Reach out:
+
+- Email: [1410770089@qq.com](mailto:1410770089@qq.com)
+- GitHub: [@woshilaohei](https://github.com/woshilaohei)
+
+**Author:** Lao Hei

{mindcore_memory-0.1.2 → mindcore_memory-0.1.4}/mindcore_memory/__init__.py

@@ -1,13 +1,13 @@
-"""
-MindCore Memory MCP
-"""
-
-from .memory_engine import MemoryEngine, MemoryEntry, RetrievalResult, MemoryImportance
-from . import server
-
-__all__ = [
-    "MemoryEngine",
-    "MemoryEntry", 
-    "RetrievalResult",
-    "MemoryImportance",
-]
+"""
+MindCore Memory MCP
+"""
+
+from .memory_engine import MemoryEngine, MemoryEntry, RetrievalResult, MemoryImportance
+from . import server
+
+__all__ = [
+    "MemoryEngine",
+    "MemoryEntry", 
+    "RetrievalResult",
+    "MemoryImportance",
+]