Memex MCP

🚀 MEMEX

MEMEX 是一個模型上下文協議（MCP）服務器，用於管理你的 指南 和 上下文 知識庫。它結合了 “記憶（Memory）” 和 “索引（Index）” 的概念，受 Vannevar Bush 1945 年富有遠見的 Memex 啟發，通過提供對技術指南和可重複使用上下文的持久訪問，增強了人工智能的記憶能力。

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

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   • 免費使用 - 無附加條件                                       │
│                                                                 │
│  本項目採用 MIT 許可協議，以最大程度地促進其應用，並幫助儘可能多的開發者。我們相信開源是通過自願貢獻而非法律義務來實現的。  │
│                                                                 │
│   • 發現了漏洞？構建了很酷的東西？                              │
│   • 我們歡迎你通過提交問題或拉取請求來做出貢獻！                │
│                                                                 │
│  有關指南，請參閱 CONTRIBUTING.md。                            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

許可證: MIT - 可在任何項目中自由使用。

📖 文檔: USAGE.md (完整指南) | AGENTS.md (適用於人工智能代理)

✨ 主要特性

• 📚 雙知識庫：可同時管理技術指南和可重複使用的上下文。
  • 指南：提供分步實施說明。
  • 上下文：包含用於人工智能交互的角色、約定和提示。
• ✍️ 編寫工具：可直接從 Claude 創建和更新指南/上下文。
• 🔍 搜索工具：通過語義搜索檢索指南和上下文。
• 🗑️ 刪除工具：清理過時內容。
• 📋 列表工具：瀏覽所有可用的指南和上下文。
• 🔍 向量搜索：由 Ollama 嵌入提供支持的語義搜索。
• 🚀 Claude 人工智能集成：通過 MCP 協議與 Claude 3.7+ 兼容。
• 📁 靈活存儲：可使用自定義知識庫路徑，且可在項目間共享。

📦 安裝指南

系統要求

• PHP 8.3+
• Composer
• 帶有 nomic-embed-text 模型的 Ollama（用於語義搜索） - 安裝 Ollama
• Node.js 20+（用於 MCP 檢查器集成測試）
• 基於 Symfony MCP SDK 構建（官方 Symfony 人工智能 SDK）

支持的操作系統

• macOS ✅
• Linux ✅
• Windows ❌（不支持）

下載最新版本

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

自我更新

安裝後，可使用以下命令保持 MEMEX 為最新版本：

./memex self-update

🚀 快速開始

make install                    # 安裝依賴項
ollama pull nomic-embed-text   # 設置 Ollama 以進行語義搜索
make build                      # 構建二進制文件
./memex server                  # 運行服務器

完整的設置說明請參閱：USAGE.md

📚 詳細文檔

配置

知識庫路徑

可通過三種方式配置知識庫位置（優先級：CLI > 本地配置 > 全局配置 > 默認）：

1. CLI 標誌：./memex server --kb=/path/to/kb
2. 本地配置：./memex.json（特定於項目）
3. 全局配置：~/.memex/memex.json（用戶範圍）

配置文件格式：

{
  "knowledgeBase": "/absolute/path/to/kb"
}

默認值：~/.memex/knowledge-base（如果未提供配置）

Claude 桌面版

{
  "mcpServers": {
    "memex": {
      "command": "/absolute/path/to/memex-mcp/memex",
      "args": ["server"]
    }
  }
}

自定義知識庫：可在 args 數組中添加 "--kb=/path"（如果使用配置文件則可選）。

所有配置選項（OpenCode、自定義知識庫等）請參閱：USAGE.md

MCP 工具

指南：get_guide、list_guides、write_guide、delete_guide 上下文：get_context、list_contexts、write_context、delete_context

知識庫結構

knowledge-base/
├── guides/      # 技術操作指南文檔
├── contexts/    # 人工智能角色/提示
└── .vectors/    # 包含嵌入的 SQLite 數據庫

文件使用帶有 YAML 前置元數據的 Markdown 格式。詳細信息請參閱：USAGE.md

從源代碼構建

make build

此命令將創建一個包含所有依賴項的獨立 ./memex 二進制文件。

手動構建：

symfony composer install
vendor/jolicode/castor/bin/castor repack --app-name=memex --logo-file=.castor.logo.php
mv memex.linux.phar memex
chmod +x memex

驗證：

./memex server
./memex stats

分發：複製 memex 二進制文件。需要 PHP 8.3+ 和 Ollama。

🔧 技術細節

設計初衷

受 Vannevar Bush 1945 年關於即時存儲和檢索知識設備的設想啟發，MEMEX 為人工智能提供了用於指南和上下文的持久記憶。

架構

基於 PHP 8.3+ 和 Symfony MCP SDK 構建，MEMEX 使用：

• 服務：指南/上下文管理、Markdown 到 JSON 編譯、語義搜索（Ollama 嵌入）
• 工具：8 個 MCP 工具（用於指南/上下文的獲取、列表、寫入、刪除）
• CLI：Castor 框架，編譯為 PHAR 二進制文件
• 安全：輸入驗證、路徑遍歷保護、1MB 內容限制

測試

make test          # PHPUnit
make test-mcp      # MCP 集成測試（需要 Node.js）

有關 CI/CD 詳細信息，請參閱 AGENTS.md。

由 Jacques Bodin-Hullin @ MonsieurBiz 使用 OpenCode 創建，結合了一點人工智能和大量掌握人工智能的時間