MEMEX

         ███╗   ███╗███████╗███╗   ███╗███████╗██╗  ██╗
         ████╗ ████║██╔════╝████╗ ████║██╔════╝╚██╗██╔╝
         ██╔████╔██║█████╗  ██╔████╔██║█████╗   ╚███╔╝ 
         ██║╚██╔╝██║██╔══╝  ██║╚██╔╝██║██╔══╝   ██╔██╗ 
         ██║ ╚═╝ ██║███████╗██║ ╚═╝ ██║███████╗██╔╝ ██╗
         ╚═╝     ╚═╝╚══════╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═╝

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   • FREE TO USE - NO STRINGS ATTACHED                           │
│                                                                 │
│  This project is MIT licensed to maximize adoption and help     │
│  as many developers as possible. We believe in open source      │
│  through voluntary contribution rather than legal obligation.   │
│                                                                 │
│   • Found a bug? Built something cool?                          │
│   • We'd love your contribution via issue or PR!                │
│                                                                 │
│  See CONTRIBUTING.md for guidelines.                            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

License: MIT - Use freely in any project.

MEMory + indEX - A Model Context Protocol (MCP) server for managing your knowledge base of guides and contexts.

Inspired by Vannevar Bush's visionary Memex (1945), MEMEX augments AI memory by providing persistent access to technical guides and reusable contexts.

📖 Documentation: USAGE.md (complete guide) | AGENTS.md (for AI agents)

Features

• 📚 Dual Knowledge Base: Manage both technical guides and reusable contexts
  • Guides: Step-by-step implementation instructions
  • Contexts: Personas, conventions, and prompts for AI interactions
• ✍️ Write Tools: Create and update guides/contexts directly from Claude
• 🔍 Search Tools: Retrieve guides and contexts with semantic search
• 🗑️ Delete Tools: Clean up obsolete content
• 📋 List Tools: Browse all available guides and contexts
• 🔍 Vector Search: Semantic search powered by Ollama embeddings
• 🚀 Claude AI Integration: Compatible with Claude 3.7+ via MCP protocol
• 📁 Flexible Storage: Use custom knowledge base paths, shareable across projects

Requirements

• PHP 8.3+
• Composer
• Ollama with nomic-embed-text model (for semantic search) - Install Ollama
• Built with official MCP SDK (mcp/sdk)

Supported Operating Systems

• macOS ✅
• Linux ✅
• Windows ❌ (not supported)

Default knowledge base location: ~/.memex/knowledge-base

Quick Start

make install                    # Install dependencies
ollama pull nomic-embed-text   # Setup Ollama for semantic search
make build                      # Build binary
./memex server                  # Run server

Complete setup instructions: USAGE.md

Installation

Download Latest Release

curl -L https://github.com/jacquesbh/memex-mcp/releases/latest/download/memex -o memex
chmod +x memex
./memex --version

Self-Update

Once installed, keep MEMEX up-to-date:

./memex self-update

Configuration

Knowledge Base Path

Configure your knowledge base location in three ways (priority: CLI > Local config > Global config > Default):

1. CLI Flag: ./memex server --kb=/path/to/kb
2. Local Config: ./memex.json (project-specific)
3. Global Config: ~/.memex/memex.json (user-wide)

Config file format:

{
  "knowledgeBase": "/absolu

... [View full README on GitHub](https://github.com/jacquesbh/memex-mcp#readme)