mcpField
M
mcp-external-memory

mcp-external-memory

ローカル
github.com/daedalusメモリ・ナレッジ027 週間前に更新
リポジトリ

mcp-external-memory について

mcp-external-memoryは、LLM向けにテキストの記憶を永続保存して検索するMCPサーバーです。名前空間とタグに対応し、TF-IDF、OpenAI、Ollamaの埋め込みバックエンドを利用できます。

主な機能

  1. 01記憶の保存・更新・削除
  2. 02意味に基づく記憶検索
  3. 03記憶の取得・一覧表示
  4. 04名前空間やタグによる絞り込み
  5. 05TF-IDF、OpenAI、Ollamaの埋め込み

活用シーン

  1. 01ユーザーの好みを保存して後で参照
  2. 02保存したメモを意味で検索
  3. 03名前空間やタグで記憶を整理

MCP 対応

記憶の保存、検索、取得、一覧表示、更新、削除のツールと、記憶統計の確認機能を提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "daedalus-mcp-external-memory": {
      "command": "uvx",
      "args": [
        "mcp-external-memory"
      ]
    }
  }
}
起動コマンドuvx mcp-external-memory

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypimcp-external-memory0.1.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

mcp-external-memory

LLM に永続的で検索可能なセマンティックメモリを提供する MCP サーバーです。

PyPI Python Coverage Ruff

インストール

pip install mcp-external-memory

使用方法

from mcp_external_memory import memory_store, memory_search

# Store a memory
result = memory_store(content="Alice prefers dark mode", namespace="users", tags=["alice", "ui"])

# Search memories
results = memory_search(query="what does Alice prefer?", namespace="users")

CLI

mcp-external-memory --help

API

ツール
ツール説明
memory_storeテキストを保存します。名前空間、タグ、メタデータは任意で指定できます
memory_searchすべてのメモリを対象にセマンティック検索します（コサイン類似度）
memory_getID を指定して単一のメモリを取得します
memory_deleteID を指定してメモリを削除します
memory_list名前空間またはタグでの絞り込みとページネーションを任意で指定して、メモリの一覧を取得します
memory_statsメモリ数、名前空間数、DB パスを取得します
memory_update既存のメモリを更新します
埋め込みバックエンド

このサーバーは複数の埋め込みバックエンドに対応しています。

  • TF-IDF（デフォルト）：純粋な Python で動作し、外部依存関係はありません
  • OpenAI：text-embedding-3-small モデルを使用します
  • Ollama：Ollama を使用したローカル埋め込み

MEMORY_EMBED_BACKEND 環境変数で設定します。

開発

git clone https://github.com/daedalus/mcp-external-memory.git
cd mcp-external-memory
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

MCP レジストリ

mcp-name: io.github.daedalus/mcp-external-memory

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。