Zed MCP Server Basic Memory. Signed-off-by: Ossfellow <ossfellow@users.noreply.github.com>

Signed-off-by: ossfellow <masoudbahar@gmail.com>

Author: ossfellow

.github/workflows/release.yml

@@ -0,0 +1,18 @@
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  release:
+    name: Release Zed Extension
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: huacnlee/zed-extension-action@v1
+        with:
+          extension-name: mcp-server-basic-memory
+          # extension-path: extensions/${{ extension-name }}
+          push-to: ossfellow/zed-mcp-server-basic-memory
+        env:
+          # the personal access token should have "repo" & "workflow" scopes
+          COMMITTER_TOKEN: ${{ secrets.COMMITTER_TOKEN }}

.gitignore

@@ -0,0 +1,13 @@
+# Generated by Cargo
+# will have compiled files and executables
+debug/
+target/
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# Helper files
+git-push.sh

Cargo.toml

@@ -0,0 +1,17 @@
+[package]
+name = "mcp_server_basic_memory"
+version = "0.0.1"
+edition = "2021"
+publish = false
+license = "Apache-2.0"
+description = "A Zed Editor extension that provides Basic Memory integration via MCP"
+authors = ["Ossfellow <ossfellow@users.noreply.github.com>"]
+repository = "https://github.com/ossfellow/zed-mcp-server-basic-memory"
+
+[lib]
+path = "src/mcp_server_basic_memory.rs"
+crate-type = ["cdylib"]
+
+[dependencies]
+serde = "1.0"
+zed_extension_api = "0.4.0"

README.md

@@ -0,0 +1,110 @@
+# Basic Memory MCP Server Extension for Zed
+
+This extension integrates [Basic Memory](https://github.com/basicmachines-co/basic-memory) as a context server for [Zed's](https://zed.dev) [Assistant](https://zed.dev/docs/assistant/assistant).
+
+Basic Memory lets you build persistent knowledge through natural conversations with Large Language Models, while keeping everything in simple Markdown files on your computer.
+
+## Prerequisites
+
+- Python 3.12+
+- [uv](https://github.com/astral-sh/uv) installed
+
+> **⚠️ Important Note**: This extension currently requires Zed to support MCP tools, which is still in development. While you can install the extension now, its functionality will become available once Zed adds MCP tools support in a future update. Follow [Zed's releases](https://github.com/zed-industries/zed/releases) for updates.
+
+## Installation
+
+### 1. Install uv and Basic Memory
+
+```bash
+pip install uv
+uv tool install basic-memory
+```
+
+### 2. Install the extension
+
+Navigate to: **Zed** > **Extensions**. Or use the command palette to search for "extensions".
+
+### 3. Configure the extension
+
+Add the following to your Zed settings:
+
+```json
+{
+  "context_servers": {
+    "mcp-server-basic-memory": {
+      "settings": {
+        "project": "optional-project-name"
+      }
+    }
+  }
+}
+```
+
+The `project` setting is optional:
+
+- If specified, Basic Memory will use the named project for storing and accessing notes
+- If omitted, Basic Memory will use its default project (typically stored in `~/basic-memory/config.json`, or set in the `BASIC_MEMORY_PROJECT` environment variable)
+
+You can configure these settings either:
+
+- Globally in your Zed settings.json
+- Per-project in your project settings
+- Or omit them to use Basic Memory's default project
+
+## Usage
+
+Once configured, Basic Memory will be available in the Zed Assistant. You can use prompts like:
+
+- "Create a note about software architecture patterns"
+- "What do I know about functional programming?"
+- "Search my notes for information about React hooks"
+
+## Multiple Projects
+
+Basic Memory supports multiple projects to separate different kinds of notes. If you work on different codebases or subjects, you might want to maintain separate knowledge bases for each.
+
+## Building the Extension
+
+This extension needs to be compiled to WebAssembly (WASM):
+
+1. **Add the WASM target to your Rust toolchain:**
+
+   ```
+   rustup target add wasm32-wasip1
+   ```
+
+2. **Build the extension:**
+
+   ```
+   cargo build --target wasm32-wasip1 --release
+   ```
+
+### Local Testing
+
+For testing locally:
+
+1. Build the extension as described above
+2. In Zed, open Extensions (⌘ + Shift + E)
+3. Click "Install Dev Extension" and select the extension directory
+4. Your dev extension will override any published version with the same name
+
+> Note: When installing as a dev extension, Zed will automatically use the build artifacts from your target directory.
+
+## Basic Memory Resources
+
+For more detailed information about Basic Memory, visit:
+
+- [Basic Memory Documentation](https://memory.basicmachines.co/)
+- [GitHub Repository](https://github.com/basicmachines-co/basic-memory)
+
+## License
+
+This project is licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at:
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+This extension interfaces with the `basic-memory` MCP server, which is a separate product developed by [Basic Machines](https://github.com/basicmachines-co) and is licensed under the GNU Affero General Public License, Version 3.0 (AGPL-3.0). The `basic-memory` MCP server's license can be found at:
+
+    https://www.gnu.org/licenses/agpl-3.0.html
+
+Please note that while this extension is distributed under the Apache 2.0 License, if you use the `basic-memory` MCP server through this extension, you must comply with its AGPL-3.0 license terms. This extension itself does not incorporate any code from the `basic-memory` MCP server; it only provides an interface to communicate with it as an external service.

extension.toml

@@ -0,0 +1,10 @@
+id = "mcp-server-basic-memory"
+name = "Basic Memory MCP Server"
+description = "Model Context Protocol Server for building persistent knowledge with Basic Memory"
+version = "0.0.1"
+schema_version = 1
+authors = ["Ossfellow <ossfellow@users.noreply.github.com>"]
+repository = "https://github.com/ossfellow/zed-mcp-server-basic-memory"
+
+[context_servers.mcp-server-basic-memory]
+name = "Basic Memory MCP Server"

extension.wasm

@@ -0,0 +1,95 @@
+//! Basic Memory MCP Server Extension for Zed
+//!
+//! This extension integrates Basic Memory's context server with Zed editor through the MCP protocol.
+//! It provides project-aware context and memory capabilities by managing the communication between
+//! Zed and the Basic Memory server.
+//!
+//! # Features
+//! - Project-specific context management
+//! - Integration with Basic Memory through `uvx` command
+//! - Configurable project settings
+//!
+//! # Configuration
+//! The extension can be configured through Zed's settings.json or project settings:
+//! ```json
+//! {
+//!   "context_servers": {
+//!     "mcp-server-basic-memory": {
+//!       "settings": {
+//!         "project": "optional-project-name"  // Optional: Specify a project name for context isolation
+//!       }
+//!     }
+//!   }
+//! }
+//! ```
+//!
+//! # Requirements
+//! - `uvx` command-line tool must be installed (`pip install uv`)
+
+use serde::Deserialize;
+use std::process::Command as ProcessCommand;
+use zed::settings::ContextServerSettings;
+use zed_extension_api::{self as zed, serde_json, Command, ContextServerId, Project, Result};
+
+// Project is a valid setting for Basic Memory
+#[derive(Debug, Deserialize)]
+struct BasicMemoryContextServerSettings {
+    // Optional project name
+    project: Option<String>,
+}
+
+// Basic Memory context server extension
+struct BasicMemoryModelContextExtension;
+
+impl zed::Extension for BasicMemoryModelContextExtension {
+    fn new() -> Self {
+        Self
+    }
+
+    // Returns the command to run the Basic Memory context server
+    fn context_server_command(
+        &mut self,
+        _context_server_id: &ContextServerId,
+        project: &Project,
+    ) -> Result<Command> {
+        // First, verify that uvx is available
+        if !is_uvx_available() {
+            return Err("'uvx' command not found. Please install uv: 'pip install uv'".into());
+        }
+
+        // Get settings from Zed project configuration
+        let settings = ContextServerSettings::for_project("mcp-server-basic-memory", project)?;
+
+        // Create command with standard args structure
+        // Important: `--project` must come BEFORE "mcp" in the args list
+        let mut args = vec!["basic-memory".to_string()];
+
+        // Add project flag if specified - it must go BEFORE the "mcp" command
+        if let Some(settings_value) = settings.settings {
+            let settings: BasicMemoryContextServerSettings =
+                serde_json::from_value(settings_value).map_err(|e| e.to_string())?;
+
+            if let Some(project_name) = settings.project {
+                args.push("--project".to_string());
+                args.push(project_name);
+            }
+        }
+
+        // Add the mcp command AFTER any project specification
+        args.push("mcp".to_string());
+
+        // Return the command configuration
+        Ok(Command {
+            command: "uvx".to_string(),
+            args,
+            env: vec![], // No environment variables needed in the standard config
+        })
+    }
+}
+
+// Helper function to check if uvx is available
+fn is_uvx_available() -> bool {
+    ProcessCommand::new("uvx").arg("--version").output().is_ok()
+}
+
+zed::register_extension!(BasicMemoryModelContextExtension);