MEMEX

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

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   • 免费使用 - 没有任何附加条件                           │
│                                                                 │
│  本项目采用MIT许可协议，以最大化其应用范围，并帮助尽可能多的开发人员。我们相信通过自愿贡献而非法律义务来支持开源。│
│                                                                 │
│   • 发现了bug？或者构建了很酷的东西？                          │
│   • 我们非常欢迎您通过issue或PR进行贡献！                      │
│                                                                 │
│  查看CONTRIBUTING.md获取指南。                                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

许可证: MIT - 在任何项目中自由使用。

---

MEMory + indEX - 一个用于管理您的知识库（包括指南和上下文）的模型上下文协议（MCP）服务器。

受Vannevar Bush在1945年提出的Memex的启发，MEMEX通过提供对技术指南和可重用上下文的持久访问来增强AI的记忆。

📖 文档: USAGE.md（完整指南） | AGENTS.md（针对AI代理）

功能

• 📚 双知识库: 管理技术指南和可重用上下文
  • 指南: 分步实施说明
  • 上下文: 用于AI交互的人格、惯例和提示
• ✍️ 编写工具: 直接从Claude创建和更新指南/上下文
• 🔍 搜索工具: 使用语义搜索检索指南和上下文
• 🗑️ 删除工具: 清理过时的内容
• 📋 列表工具: 浏览所有可用的指南和上下文
• 🔍 向量搜索: 由Ollama嵌入驱动的语义搜索
• 🚀 Claude AI 集成: 通过MCP协议与Claude 3.7+兼容
• 📁 灵活存储: 使用自定义知识库路径，跨项目共享

要求

• PHP 8.3+
• Composer
• Ollama 带有 nomic-embed-text 模型（用于语义搜索） - 安装Ollama
• Node.js 20+（用于MCP Inspector集成测试）
• 使用Symfony MCP SDK 构建（官方Symfony AI SDK）

支持的操作系统

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

默认知识库位置: ~/.memex/knowledge-base

快速开始

make install                    # 安装依赖
ollama pull nomic-embed-text   # 设置Ollama用于语义搜索
make build                      # 构建二进制文件
./memex server                  # 运行服务器

完整设置说明：USAGE.md

安装

下载最新版本

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

自动更新

一旦安装，保持MEMEX更新：

./memex self-update

配置

知识库路径

通过三种方式配置您的知识库位置（优先级：命令行 > 本地配置 > 全局配置 > 默认值）：

1. 命令行标志: ./memex server --kb=/path/to/kb
2. 本地配置: ./memex.json（项目特定）
3. 全局配置: ~/.memex/memex.json（用户范围）

配置文件格式:

{
  "knowledgeBase": "/绝对路径/to/kb"
}

默认值: ~/.memex/knowledge-base（如果没有提供配置）

Claude Desktop

{
  "mcpServers": {
    "memex": {
      "command": "/绝对路径/to/memex-mcp/memex",
      "args": ["server"]
    }
  }
}

自定义KB: 将 "--kb=/path" 添加到 args 数组中（如果使用配置文件则可选）。

所有配置选项（OpenCode、自定义KB等）：USAGE.md

MCP工具

指南: get_guide, list_guides, write_guide, delete_guide 上下文: get_context, list_contexts, write_context, delete_context

知识库结构

knowledge-base/
├── guides/      # 技术指南
├── contexts/    # AI人格/提示
└── .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。

为什么选择MEMEX？

受Vannevar Bush在1945年的愿景启发，即一种能够即时存储和检索知识的设备，MEMEX通过持久记忆增强了AI，使其能够处理指南和上下文。

架构

使用PHP 8.3+和Symfony MCP SDK，MEMEX使用：

• 服务: 指南/上下文管理、Markdown→JSON编译、语义搜索（Ollama嵌入）
• 工具: 8个MCP工具（获取、列表、编写、删除指南/上下文）
• CLI: [Castor](https://github.com/jolicode/cast