Memex MCP (Jacquesbh)

记忆延伸


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

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   • 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.                            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

许可证： 麻省理工学院 -在任何项目中自由使用。

______________________________________________________________________

内存ory+ind前任 -用于管理您的知识库的模型上下文协议（MCP）服务器 指南 和 上下文.

灵感来自Vannevar Bush的远见卓识 Memex （1945），MEMEX通过提供对技术指南和可重用上下文的持久访问来增强AI内存。

📖 文档： 用法.md （完整指南）| 代理商.md （适用于AI代理）

特性

• 📚 双重知识库：管理技术指南和可重用上下文

- 指南：分步实施说明 - 上下文：人工智能交互的角色、约定和提示

• ✍️ 写入工具：直接从Claude创建和更新指南/上下文
• 🔍 搜索工具：使用语义搜索检索指南和上下文
• 🗑️ 删除工具：清理过时的内容
• 📋 列出工具：浏览所有可用的指南和上下文
• 🔍 向量搜索：Ollama嵌入技术支持的语义搜索
• 🚀 Claude AI集成：通过MCP协议与Claude 3.7+兼容
• 📁 灵活的存储：使用可跨项目共享的自定义知识库路径

需求

• PHP 8.3+
• 作曲家
• 奥拉玛 随着 nomic-embed-text 模型（用于语义搜索）- 安装Ollama
• 与官方合作建造 MCP-SDK (mcp/sdk)

支持的操作系统

• macOS ✅
• Linux ✅
• 视窗 ❌ （不支持）

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

快速开始

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

完整的设置说明： 用法.md

安装

下载最新版本

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

自我更新

安装后，请保持MEMEX最新：

./memex self-update

配置

知识库路径

通过三种方式配置知识库位置（优先级：CLI>本地配置>全局配置>默认）：

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

配置文件格式：

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

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

克劳德桌面

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

自定义知识库：添加 "--kb=/path" 到 args array（如果使用配置文件，则可选）。

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

MCP工具（10）

知识库结构

knowledge-base/
├── guides/      # Technical how-to docs
├── contexts/    # AI personas/prompts
└── .vectors/    # SQLite database with embeddings

文件使用Markdown和YAML frontmatter。细节： 用法.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通过对指南和上下文的持久记忆来增强人工智能。

建筑

使用PHP 8.3+和官方 MCP-SDK，MEMEX使用：

• 服务： 指南/上下文管理，Markdown→JSON编译、语义搜索（Ollama嵌入）
• 工具： 10个MCP工具（用于指南/上下文的CRUD+UUID生成+语义搜索）
• CLI： 蓖麻 框架，编译为PHAR二进制文件
• 安全： 输入验证、路径遍历保护、1MB内容限制

测试

make test          # PHPUnit
make test-mcp      # MCP integration tests (requires Node.js)

看 代理商.md 有关CI/CD的详细信息。

______________________________________________________________________