MemoFS MCP Server

@memofs/mcp-server

         

MemoFS のエージェント連携向け Model Context Protocol サーバーです。

これは何ですか？

@memofs/mcp-server パッケージを使うと、AI コーディングエージェント（Claude Desktop、Cursor、Zed、OpenCode など）が Model Context Protocol（MCP）を通じて、プロジェクトのメモリーを安全に読み取り、検索、更新できます。コアランタイムをラップし、モデル向けのツール 10 個（メモリー操作 4 個＋AgentFS セッションツール 6 個）と、メモリー、グラフ、セッションにアクセスするためのリソース 9 個を公開します。

主な機能：

• コードアンカー — memofs.remember は、メモリーをソースファイルに紐付けるための任意の anchor パラメーターを受け付けます。紐付けられたファイルが変更されると、memofs.recall は stale フラグを返します。
• メモリーの減衰検出 — メモリーが種類ごとの減衰しきい値を超えると、検索結果に unverified フラグが付与されます。
• セッションの結果 — memofs_agent_session_complete は、永続メモリーへの昇格とワークスペースのクリーンアップを制御する 5 行の動作マトリックスに対応する outcome、ephemeral、reason パラメーターを受け付けます。

インストール

ほとんどの MCP クライアントは npx を使って必要に応じてサーバーを起動するため、インストールは不要です。

npx -y @memofs/mcp-server --help

サーバーを dev dependency としてインストールする場合は、次のようにします。

npm install -D @memofs/mcp-server

Node.js >= 22 が必要です。

または、クライアントの設定から npx で直接実行することもできます。

npx -y @memofs/mcp-server --help

クイックスタート

MCP クライアント（Claude Desktop、Cursor、その他の MCP クライアントなど）を設定して、stdio 経由でサーバーを起動できます。

MCP クライアントの設定

{
  "mcpServers": {
    "memofs": {
      "command": "npx",
      "args": [
        "-y",
        "@memofs/mcp-server",
        "--runtime",
        "local",
        "--root",
        "/absolute/path/to/project"
      ]
    }
  }
}

設定と使い方

サーバーは 2 つのランタイムモード（local、hybrid）と、--cloud-url および --api-key によるクラウド同期に対応しています。また、信頼できないクライアントで使用する際に、変更を伴うツールをブロックする厳格な --read-only フラグも備えています。

主要な AI ツール全般にわたる包括的なセットアップ手順、公開されているツールとリソースの一覧、ランタイムモードのオプションについては、完全なドキュメントを参照してください。

コントリビューション

モノレポ内でのフォーマット、リント、テストの詳細については、共通のコントリビューションガイドと開発スクリプトを参照してください。

ライセンス

MIT