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. Rust ツールチェーンに WASM ターゲットを追加します。

   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 Machines が開発した別製品であり、GNU Affero General Public License, Version 3.0（AGPL-3.0）の下でライセンスされている basic-memory MCP サーバーと連携します。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 サーバーのコードは含まれておらず、外部サービスとして同サーバーと通信するためのインターフェースのみを提供します。