Basic Memory MCP Server Extension for Zed Editor

Zed Editor 的 Basic Memory MCP 服务扩展

此扩展将 Basic Memory 集成为 Zed Editor 助手 的上下文服务。

Basic Memory 让你能够通过与大模型的自然对话构建持久知识，同时将所有内容保存在电脑上的简单 Markdown 文件中。

前置条件

• Python 3.12+
• 已安装 uv

⚠️ 重要提示：此扩展目前需要 Zed 支持 MCP 工具，而该功能仍在开发中。你现在可以安装此扩展，但要等到 Zed 在未来的更新中添加 MCP 工具支持后，扩展功能才会启用。请关注 Zed 的发行版本以获取更新。

安装

1. 安装 uv 和 Basic Memory

pip install uv
uv tool install basic-memory

2. 安装扩展

前往：Zed > Extensions。或者使用命令面板搜索“extensions”。

3. 配置扩展

将以下内容添加到 Zed 设置中：

{
  "context_servers": {
    "mcp-server-basic-memory": {
      "settings": {
        "project": "optional-project-name"
      }
    }
  }
}

project 设置是可选的：

• 如果指定，Basic Memory 将使用指定的项目来存储和访问笔记
• 如果省略，Basic Memory 将使用默认项目（通常存储在 ~/basic-memory/config.json 中，或通过 BASIC_MEMORY_PROJECT 环境变量设置）

你可以通过以下方式配置这些设置：

• 在 Zed 的 settings.json 中进行全局配置
• 在项目设置中进行单项目配置
• 或者省略这些设置，以使用 Basic Memory 的默认项目

使用方法

配置完成后，Basic Memory 将在 Zed 助手中可用。你可以使用以下提示词：

• “创建一条关于软件架构模式的笔记”
• “我对函数式编程了解些什么？”
• “在我的笔记中搜索有关 React hooks 的信息”

多个项目

Basic Memory 支持多个项目，以便分类存放不同类型的笔记。如果你从事不同的代码库或主题，可能需要为每个项目维护单独的知识库。

构建扩展

此扩展需要编译为 WebAssembly（WASM）：

1. 将 WASM 目标添加到 Rust 工具链中：

   rustup target add wasm32-wasip1
   

2. 构建扩展：

   cargo build --target wasm32-wasip1 --release
   

本地测试

要在本地测试：

1. 按照上述说明构建扩展
2. 在 Zed 中打开 Extensions（⌘ + Shift + E）
3. 点击“Install Dev Extension”，然后选择扩展目录
4. 你的开发扩展将覆盖同名的任何已发布版本

注意：作为开发扩展安装时，Zed 将自动使用目标目录中的构建产物。

Basic Memory 资源

如需了解 Basic Memory 的更多详细信息，请访问：

• Basic Memory 文档
• GitHub 仓库

许可证

本项目根据 Apache License, Version 2.0（“许可证”）授权。你可以通过以下地址获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

此扩展与 basic-memory MCP 服务交互。该服务是由 Basic Machines 开发的独立产品，并根据 GNU Affero General Public License, Version 3.0（AGPL-3.0）授权。basic-memory MCP 服务的许可证可在以下地址查看：

https://www.gnu.org/licenses/agpl-3.0.html

请注意，虽然此扩展根据 Apache 2.0 License 分发，但如果你通过此扩展使用 basic-memory MCP 服务，则必须遵守其 AGPL-3.0 许可证条款。此扩展本身不包含 basic-memory MCP 服务的任何代码；它仅提供与该服务作为外部服务进行通信的接口。