Evangstav Python Memory MCP Server

🚀 記憶 MCP サーバー

Claude の記憶と知識グラフを管理するための Model Context Protocol (MCP) サーバーの実装です。

🚀 クイックスタート

この記憶 MCP サーバーは、Claude の記憶と知識グラフを効果的に管理するためのものです。以下に、サーバーのインストール、使用方法、開発、テストに関する詳細を説明します。

📦 インストール

以下の方法でこのパッケージをインストールできます。

uv を使用したインストール

uvx memory-mcp-server

リポジトリからのインストール

uv pip install git+https://github.com/estav/python-memory-mcp-server.git

💻 使用例

基本的な使用法

インストールが完了したら、以下のコマンドでサーバーを起動できます。

uvx memory-mcp-server

設定

サーバーは以下の環境変数の設定を期待しています。

• DATABASE_URL：知識グラフを保存するための SQLite データベースの URL
• その他の設定変数を追加...

Claude Desktop との統合

この MCP サーバーを Claude Desktop と一緒に使用するには、claude_desktop_config.json に以下の内容を追加してください。

{
  "mcpServers": {
    "memory": {
      "command": "uvx",
      "args": ["memory-mcp-server"]
    }
  }
}

📚 ドキュメント

開発手順

1. リポジトリをクローンします。

git clone https://github.com/estav/python-memory-mcp-server.git
cd python-memory-mcp-server

2. 仮想環境を作成し、依存関係をインストールします。

uv venv
source .venv/bin/activate
uv pip install -e ".[test]"  # テスト依存関係を含む

3. テストを実行します。

pytest                    # すべてのテストを実行
pytest -v                # 詳細出力で実行
pytest -v --cov         # カバレッジレポートを生成

4. ローカルでサーバーを実行します。

python -m memory_mcp_server

テスト

このプロジェクトは pytest を使用してテストされています。テストスイートには以下が含まれます。

単体テスト

• test_knowledge_graph_manager.py：知識グラフの基本操作のテスト
• test_optimized_knowledge_graph_manager.py：最適化/バッチ操作のテスト
• test_server.py：MCP サーバー実装のテスト

テストの実行

# すべてのテストを実行
pytest

# カバレッジレポートを生成
pytest --cov=memory_mcp_server

# 特定のテストファイルを実行
pytest tests/test_server.py

# 詳細出力でテストを実行
pytest -v

テストファームウェア

conftest.py ファイルはいくつかの一般的なテストファームウェアを提供しています。

• temp_db_path：一時的な SQLite データベースを作成
• knowledge_graph_manager：KnowledgeGraphManager インスタンスを提供
• optimized_knowledge_graph_manager：OptimizedKnowledgeGraphManager インスタンスを提供

📄 ライセンス

このプロジェクトは MIT ライセンスの下でオープンソース化されています。詳細については、LICENSE ファイルを参照してください。