记忆延伸
███╗ ███╗███████╗███╗ ███╗███████╗██╗ ██╗
████╗ ████║██╔════╝████╗ ████║██╔════╝╚██╗██╔╝
██╔████╔██║█████╗ ██╔████╔██║█████╗ ╚███╔╝
██║╚██╔╝██║██╔══╝ ██║╚██╔╝██║██╔══╝ ██╔██╗
██║ ╚═╝ ██║███████╗██║ ╚═╝ ██║███████╗██╔╝ ██╗
╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝
┌─────────────────────────────────────────────────────────────────┐
│ │
│ • 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+兼容
- 📁 灵活的存储：使用可跨项目共享的自定义知识库路径
需求
支持的操作系统
- 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>本地配置>全局配置>默认）：
- CLI标志:
./memex server --kb=/path/to/kb - 本地配置:
./memex.json（项目特定） - 全局配置:
~/.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）
| 类别 | 工具 |
|---|---|
| 指南 | get_guide, list_guides, write_guide, delete_guide |
| 上下文 | get_context, list_contexts, write_context, delete_context |
| 效用 | generate_uuid, search_knowledge_base |
知识库结构
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的详细信息。
______________________________________________________________________