Python Memory MCP Server

🚀 Memory MCP Server

The Memory MCP Server is an efficient data management tool that supports entity lifecycle management and complex query operations.

🚀 Quick Start

📦 Installation

To run the MCP server, follow these steps:

1. Clone the project repository:

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

2. Create and activate a virtual environment (Python 3.8 or higher is recommended):

python -m venv venv
source venv/bin/activate  # On Unix/MacOS
venv\Scripts\activate     # On Windows

3. Install the dependencies:

pip install -r requirements.txt

4. Start the server:

python server.py

💻 Usage Examples

Basic Usage

Here are some basic usage examples:

Retrieve an Entity

response = client.get_entity("user_123")
if response.success:
    print(response.data)
else:
    print(f"Error: {response.error}")

Update Entity Attributes

data = {
    "age": 25,
    "name": "Alice",
    "department": "Technical Department"
}
response = client.update_entity("user_123", data)

Delete an Entity

response = client.delete_entity("user_123")
if response.error_type == "NOT_FOUND":
    print("The entity does not exist.")
elif not response.success:
    print(f"Error: {response.error}")

📚 Documentation

Data Validation Rules

Entity Name Rules

• Must start with a lowercase letter.
• Can only contain letters, numbers, and underscores.
• Must be no more than 64 characters long.

Entity Type Rules

• Supported types include: "user", "system", "application", "service".

Attribute Value Rules

• Numeric types must be integers or floating-point numbers.
• String length must be no more than 256 characters.
• Must use the JSON standard data format.

Error Handling

Here are the common error types returned by the server:

• NOT_FOUND: The resource was not found.
• VALIDATION_ERROR: The input data is invalid.
• INTERNAL_ERROR: An internal server error occurred.
• INVALID_REQUEST: The request format is incorrect.

Response Models

Entity Response

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

Graph Response

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

🔧 Technical Details

Development Guide

Run Tests

pytest tests/

Add New Features

1. Update the validation rules in validation.py.
2. Add new test cases in tests/test_validation.py.
3. Implement new features in knowledge_graph_manager.py.