メモリMCP

低レベルのサーバー実装と SQLite ストレージを使用してメモリを保存および取得するためのモデル コンテキスト プロトコル サーバー。

インストール

このプロジェクトでは、依存関係の管理に pip の代わりにuvを使用します。uv は、高速で信頼性の高い Python パッケージ インストーラーおよびリゾルバーです。

uv を使用してインストールします。

uv pip install memory-mcp

またはソースから直接インストールします:

uv pip install .

開発の場合:

uv pip install -e ".[dev]"

uv がインストールされていない場合は、公式の手順に従ってインストールできます。

Related MCP server: SQLite MCP Server

使用法

サーバーの実行

memory-mcp

これにより、メモリを保存および取得できる MCP サーバーが起動します。

利用可能なツール

メモリ MCP は次のツールを提供します。

• remember ：タイトルと内容で新しい記憶を保存する

• get_memory : IDまたはタイトルで特定のメモリを取得します

• list_memories : 保存されているすべてのメモリを一覧表示する

• update_memory : 既存のメモリを更新する

• delete_memory : メモリを削除する

MCP Inspectによるデバッグ

MCP には、MCP サーバーを直接デバッグしたり操作したりできる、 mcp inspectという便利なコマンドライン ツールが用意されています。

設定

1. まず、MCP CLI ツールがインストールされていることを確認します。

uv pip install mcp[cli]

2. 1 つのターミナルで Memory MCP サーバーを起動します。

memory-mcp

3. 別のターミナルで、 mcp inspectを使用して実行中のサーバーに接続します。

mcp inspect

MCP Inspectの使用

接続すると、次のことが可能になります。

利用可能なツールの一覧

> tools

これにより、Memory MCP サーバーによって提供されるすべてのツールが表示されます。

ツールを呼び出す

ツールを呼び出すには、 callコマンドに続けてツール名と必要な引数を指定します。

> call remember title="Meeting Notes" content="Discussed project timeline and milestones."

> call list_memories

> call get_memory memory_id=1

> call update_memory memory_id=1 title="Updated Title" content="Updated content."

> call delete_memory memory_id=1

デバッグモード

デバッグ モードを有効にすると、詳細なリクエストと応答の情報を表示できます。

> debug on

これにより、サーバーに送受信されるデータを正確に把握できるようになります。

ツールスキーマの探索

特定のツールのスキーマを表示するには:

> tool remember

これには、ツールの入力スキーマ、必須パラメータ、および説明が表示されます。

トラブルシューティング

問題が発生した場合:

1. サーバーが実行されているターミナルのサーバー ログにエラー メッセージがないか確認します。

2. MCP 検査ターミナルで、 debug onしてデバッグ モードを有効にし、生の要求と応答を表示します。

3. ツール パラメータが予期されるスキーマと一致していることを確認します ( toolコマンドで確認します)。

4. サーバーがクラッシュした場合は、サーバー ターミナルでキャッチされていない例外がないか確認してください。

発達

プロジェクトに貢献するには、開発依存関係をインストールします。

uv pip install -e ".[dev]"

依存関係の管理

このプロジェクトは、依存関係をロックするためにuv.lockファイルを使用します。依存関係を更新するには、以下の手順を実行します。

uv pip compile pyproject.toml -o uv.lock

テストの実行

python -m pytest

コードのフォーマット

black memory_mcp tests

リンティング

ruff check memory_mcp tests

型チェック

mypy memory_mcp