Evangstav Python Memory MCP Server

🚀 記憶 MCP 服務器

本項目是一個用於管理 Claude 記憶和知識圖譜的 Model Context Protocol (MCP) 服務器實現，能有效助力 Claude 相關記憶及知識圖譜的管理工作。

🚀 快速開始

本服務器可通過 uv 便捷安裝，安裝完成後即可運行使用。

✨ 主要特性

• 實現了 Model Context Protocol (MCP)，可用於管理 Claude 記憶和知識圖譜。
• 支持通過 uv 或從倉庫進行安裝。
• 可與 Claude Desktop 集成使用。
• 提供了完善的開發和測試流程。

📦 安裝指南

你可以使用 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 文件。