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
   

📦 安裝指南

安裝 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 標準數據格式。

錯誤處理

以下是服務器返回的常見錯誤類型：

• 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 中實現新功能。

💻 使用示例

基礎用法

檢索實體

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}")