STARWARCLOUD STARWAR.AI
返回市场
记忆扩展-MCP

记忆扩展-MCP

作者：jacquesbh6 星标更新：2025-10-20
安装使用来源：spider==github.com

项目介绍

MEMEX

CI

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

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   • 免费使用 - 没有任何附加条件                           │
│                                                                 │
│  本项目采用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