Memory MCP

🚀 記憶 MCP サーバー

低レベルサービス実装と SQLite ストレージを使用して、記憶の保存と検索を行うモデルコンテキストプロトコル（Model Context Protocol）サーバーです。

🚀 クイックスタート

このサーバーは、低レベルサービスと SQLite を用いて記憶の保存と検索を可能にします。以下に、インストール方法と使用方法を説明します。

✨ 主な機能

• 低レベルサービス実装と SQLite ストレージを使用して、記憶の保存と検索を行う。
• 様々なコマンドラインツールを提供し、記憶の管理を容易にする。
• mcp inspect コマンドを使用して、サーバーのデバッグとインタラクションが可能。

📦 インストール

このプロジェクトでは、依存関係の管理に uv を使用しており、pip ではなく uv を用います。uv は高速かつ信頼性の高い Python パッケージインストーラーと解析器です。

uv を使用してインストールするには：

uv pip install memory-mcp

または、ソースコードから直接インストールするには：

uv pip install .

開発時には：

uv pip install -e ".[dev]"

uv がインストールされていない場合は、公式の説明に従ってインストールしてください。

💻 使用例

基本的な使用法

サーバーの起動

memory-mcp

これにより、MCP サーバーが起動し、記憶の保存と検索が可能になります。

利用可能なツール

Memory MCP は以下のツールを提供します：

• remember：タイトルと内容を持つ新しい記憶を保存します。
• get_memory：ID またはタイトルで特定の記憶を検索します。
• list_memories：保存されているすべての記憶をリストします。
• update_memory：既存の記憶を更新します。
• delete_memory：記憶を削除します。

高度な使用法

MCP インスペクトを使用したデバッグ

MCP は、mcp inspect という便利なコマンドラインツールを提供しており、MCP サーバーの直接的なデバッグとインタラクションが可能です。

セットアップ

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

uv pip install mcp[cli]

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

memory-mcp

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

mcp inspect

MCP インスペクトの使用

接続後、以下の操作を実行できます：

利用可能なツールのリスト表示

> tools

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

ツールの呼び出し

ツールを呼び出すには、call コマンドにツール名と必要なパラメーターを追加します：

> call remember title="会議記録" content="プロジェクトのスケジュールと重要なマイルストーンについて議論しました。"

> call list_memories

> call get_memory memory_id=1

> call update_memory memory_id=1 title="更新後のタイトル" 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