Memcp

🚀 MemCP - AIエージェントメモリプロトコルのメモリコンテキストプロトコル

MemCPは、IDEまたはMCP対応のLLMクライアントアプリケーション向けに設計された、モジュール化された拡張可能なAIエージェントメモリMCPサーバーです。これは、Zep AIのGraphitiにあるmcp-serverの例を拡張したもので、AIエージェントが新しい情報に応じて自動的に進化する時系列知識グラフを構築、維持、およびクエリできるようにします。

MemCPは現在、ローカルSSEまたは標準入出力（stdio）転送をサポートする任意のIDEまたはLLMクライアントアプリケーションに対応する、即時使用可能なメモリサーバーとして設計されています。

⚠️ 重要提示

このサーバーは主にCursor IDEでテストされており、他のMCP対応クライアントと比べて異なる動作をする可能性があります。

✨ 主な機能

• 時系列知識グラフ：AIエージェントが時間とともに進化する知識グラフを自動的に構築およびクエリできます。
• MCP統合：MCPをサポートする任意のクライアントと互換性があります。
• エンティティ抽出：コード固有のエンティティとその関係を自動的に抽出し、カスタマイズ機能も間もなく提供されます。
• 柔軟な設定：環境変数、TOMLファイル、またはコマンドライン引数を使用して設定できます。
• 永続的なストレージ：Neo4jを使用して知識を保存し、セッション間での永続性を実現します。
• 複数の転送サポート：SSE（HTTP）とstdioの両方の転送をサポートします。

📚 ドキュメント

完全なMemCPのドキュメントはdocsディレクトリにあります。詳細情報については、docs/README.mdを参照してください。

📦 インストール

環境要件

• オペレーティングシステム：Linux、macOS、またはWindows（Linuxの使用を推奨）
• プログラミング言語：Python 3.8以上
• 依存関係管理ツール：pip（推奨）

インストール手順

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

git clone https://github.com/your-repository/memcp.git
cd memcp

2. 依存関係をインストールします：

pip install -r requirements.txt

3. 環境変数を設定します（オプション）：
   • NEO4J_URI を設定してデータベース接続アドレスを指定します。
   • NEO4J_USER と NEO4J_PASSWORD を設定して認証に使用します。
   • OPENAI_API_KEY または ANTHROPIC_API_KEY を設定してエンティティ抽出を行います。

サービスの起動

python3 memcp_server.py

🚀 クイックスタート

基本的な使用法

1. MemCPインスタンスを初期化します：

from memcp import MemCP
mem = MemCP()

2. 知識断片を追加します：

mem.add_fact("ユーザーの好み", "赤色が好き")

3. 知識グラフをクエリします：

print(mem.get_facts())

高度な使用法

エンティティタイプ

MemCPは以下のデフォルトのエンティティタイプを定義しています：

• Preference：ユーザーの好みや傾向
• Procedure：特定のタスクを実行する手順または操作
• Requirement：製品またはサービスが満たさなければならない機能要件

--graph.use_memcp_entities フラグを使用して、これらのエンティティタイプを有効または無効にできます。

永続的なストレージ

MemCPはデータの永続化にNeo4jデータベースを使用します。デフォルトでは、データは自動的にローカルインスタンスに保存されます。カスタムデータベースアドレスを設定するには、環境変数を設定します：

export NEO4J_URI=bolt://localhost:7687

🤝 コントリビューションガイド

コントリビューションを歓迎します！詳細なガイドについては、CONTRIBUTING.mdを参照してください。

📄 ライセンス

MemCPはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。

🔚 最後の注意事項

⚠️ 重要提示

MemCPのAPI呼び出し頻度は高いです。これは、依存しているGraphitiも同様であるためです。これは正確で有用な知識グラフを生成できる一方で、高い呼び出しコストを伴います。使用時には呼び出し回数をコントロールして、費用が過度にならないように注意してください。