Python Memory MCP Server

🚀 メモリ MCP サーバー

この MCP サーバーは、エンティティのライフサイクル管理と複雑なクエリ操作をサポートする、効率的なデータ管理ツールです。

🚀 クイックスタート

MCP サーバーを実行するには、以下の手順に従ってください。

📦 インストール

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

   git clone https://github.com/your-organization/mcp.git
   cd mcp
   

2. 仮想環境を作成し、アクティブ化します（Python 3.8 以上を推奨）。

   python -m venv venv
   source venv/bin/activate  # Unix/MacOS の場合
   venv\Scripts\activate     # Windows の場合
   

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

4. サーバーを起動します。

   python server.py
   

📚 ドキュメント

データ検証ルール

エンティティ名ルール

• 小文字のアルファベットで始まる必要があります。
• アルファベット、数字、アンダースコアのみを含めることができます。
• 最大 64 文字までです。

エンティティタイプルール

• サポートされるタイプは、"user", "system", "application", "service" です。

属性値ルール

• 数値型は整数または浮動小数点数である必要があります。
• 文字列の長さは 256 文字以内です。
• JSON 標準データ形式を使用する必要があります。

💻 使用例

エンティティの検索

response = client.get_entity("user_123")
if response.success:
    print(response.data)
else:
    print(f"エラー：{response.error}")

エンティティ属性の更新

data = {
    "age": 25,
    "name": "Alice",
    "department": "技術部"
}
response = client.update_entity("user_123", data)

エンティティの削除

response = client.delete_entity("user_123")
if response.error_type == "NOT_FOUND":
    print("エンティティが存在しません。")
elif not response.success:
    print(f"エラー：{response.error}")

🔧 技術詳細

エラー処理

サーバーが返す一般的なエラータイプは以下の通りです。

• NOT_FOUND：リソースが見つかりません。
• VALIDATION_ERROR：入力データが無効です。
• INTERNAL_ERROR：サーバー内部エラーです。
• INVALID_REQUEST：リクエスト形式が誤っています。

レスポンスモデル

エンティティレスポンス

class EntityResponse(BaseModel):
    success: bool
    data: Optional[Dict[str, Any]] = None
    error: Optional[str] = None
    error_type: Optional[str] = None

グラフレスポンス

class GraphResponse(BaseModel):
    success: bool
    data: Optional[Dict[str, Any]] = None
    error: Optional[str] = None
    error_type: Optional[str] = None

開発ガイド

テストの実行

pytest tests/

新機能の追加

1. validation.py の検証ルールを更新します。
2. tests/test_validation.py に新しいテストケースを追加します。
3. knowledge_graph_manager.py で新機能を実装します。

この MCP サーバーは、エンティティのライフサイクル管理と複雑なクエリ操作をサポートする、効率的なデータ管理ツールです。上記のガイドに従うことで、簡単に機能を統合および拡張することができます。