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 创建，结合了一点人工智能和大量掌握人工智能的时间