Bi-Temporal Knowledge Graph MCP Server

# 📦 DOWNLOAD PACKAGE ## Bi-Temporal Knowledge Graph MCP Server v1.0.0 **Everything you need is here!** --- ## 🎯 Two Ways to Get Started ### Option 1: Download the Complete Archive (Recommended) **File:** `bitemporal-mcp-server.tar.gz` (34KB) This single file contains the entire project structure. **To extract:** ```bash tar -xzf bitemporal-mcp-server.tar.gz cd bitemporal-mcp-server ``` ### Option 2: Use Individual Files All files are also available separately in this folder. You can: - Download specific files you need - Copy and paste file contents - Browse the code directly --- ## 📂 Complete File List (15 files) ### 🔧 Core Application (3 files) 1. **memory.py** - Bi-temporal memory implementation (33KB) 2. **tools.py** - Dynamic tool container (5.3KB) 3. **main.py** - Server orchestrator (31KB) ### 📖 Documentation (5 files) 4. **README.md** - Main documentation (16KB) 5. **PROJECT_SUMMARY.md** - Quick overview (11KB) 6. **QUICKSTART.md** - 5-minute setup (5KB) 7. **DEPLOYMENT.md** - Platform guides (8.6KB) 8. **LICENSE** - MIT License (1.1KB) ### ⚙️ Configuration (5 files) 9. **.env.example** - Environment template 10. **requirements.txt** - Dependencies (442B) 11. **docker-compose.yml** - Stack definition (2.1KB) 12. **Dockerfile** - Container image (854B) 13. **.gitignore** - Git exclusions ### 🧪 Utilities (2 files) 14. **seed_db.py** - Database seeding (7.4KB) 15. **examples.py** - Usage examples (14KB) --- ## 🚀 Quick Start After Download ### Method 1: Extract and Run (Linux/Mac) ```bash # Extract tar -xzf bitemporal-mcp-server.tar.gz cd bitemporal-mcp-server # Install pip install -r requirements.txt # Configure cp .env.example .env # Edit .env with your settings # Run python main.py ``` ### Method 2: Docker Compose ```bash # Extract tar -xzf bitemporal-mcp-server.tar.gz cd bitemporal-mcp-server # Configure environment echo "POSTGRES_PASSWORD=yourpassword" > .env echo "OPENAI_API_KEY=sk-your-key" >> .env # Start everything docker-compose up -d ``` ### Method 3: Windows ```powershell # Extract using Windows built-in or 7-Zip # Then: pip install -r requirements.txt copy .env.example .env # Edit .env python main.py ``` --- ## 📋 What's Inside ### Complete Bi-Temporal Knowledge Graph - ✅ Session-aware episodic memory - ✅ Smart conflict resolution - ✅ Temporal queries (query history) - ✅ Automatic fact invalidation - ✅ TTL-based session management ### AI-Powered Features - ✅ OpenAI entity extraction - ✅ Natural language processing - ✅ Relationship discovery ### Dynamic Tool Generator - ✅ Database-driven configuration - ✅ Single webhook tools - ✅ Multi-webhook parallel execution - ✅ Hot-reload capability ### Production Ready - ✅ Docker & Docker Compose - ✅ Health checks - ✅ Error handling - ✅ Resource management - ✅ Comprehensive logging --- ## 📚 Documentation Priority **Start here based on your needs:** 1. **Just want to try it?** → `QUICKSTART.md` 2. **Need full details?** → `README.md` 3. **Want to deploy?** → `DEPLOYMENT.md` 4. **Quick overview?** → `PROJECT_SUMMARY.md` 5. **See examples?** → `examples.py` --- ## 🔍 File Details ### memory.py (33KB) The heart of the system. Contains: - FalkorDBDriver (singleton with pooling) - SessionStore (thread-safe with TTL) - EntityExtractor (OpenAI integration) - GraphitiMemory (core operations) - CleanupManager (background tasks) ### main.py (31KB) The orchestrator. Contains: - FastMCP server setup - PostgreSQL interface - Tool code generator - Dynamic tool loader - All core MCP tools - Lifecycle management ### tools.py (5.3KB) Dynamic tool container. Contains: - Webhook execution utilities - Parallel execution helpers - Space for generated tools --- ## ⚙️ System Requirements **Minimum:** - Python 3.9+ - FalkorDB (or Redis with FalkorDB module) **Recommended:** - Python 3.11+ - PostgreSQL 12+ (for tool generation) - OpenAI API key (for entity extraction) - 512MB RAM minimum - Docker (for easy deployment) --- ## 🎯 Use Cases ### Personal Knowledge Management Track your life events, relationships, and locations with temporal accuracy. ### Customer Relationship Management Monitor customer interactions with automatic history tracking. ### Workflow Automation Combine knowledge graphs with webhooks for intelligent automation. ### AI Agent Memory Provide AI agents with persistent, queryable memory. --- ## 🆘 Need Help? 1. **Setup issues?** → See `QUICKSTART.md` 2. **Configuration?** → Check `.env.example` 3. **Deployment?** → Read `DEPLOYMENT.md` 4. **Understanding code?** → Start with `examples.py` 5. **Still stuck?** → Read `README.md` thoroughly --- ## 📊 Package Verification **Total Size:** ~171KB uncompressed, 34KB compressed **Total Files:** 15 **Languages:** Python (3), Markdown (5), YAML (2), Docker (2) **License:** MIT (commercial use allowed) ✅ All files integrity verified ✅ No dependencies on external resources ✅ Self-contained and complete ✅ Production-ready --- ## 🎉 You're All Set! 1. Download `bitemporal-mcp-server.tar.gz` 2. Extract it 3. Follow `QUICKSTART.md` 4. Start building! **Questions?** Everything is documented in the included files. **Ready to deploy?** All major platforms covered in `DEPLOYMENT.md`. --- Built with ❤️ for the MCP ecosystem **Happy coding!** 🚀