Evangstav Python Memory MCP Server

🚀 记忆 MCP 服务器

本项目是一个用于管理 Claude 记忆和知识图谱的 Model Context Protocol (MCP) 服务器实现，能有效处理和存储相关数据，为 Claude 应用提供有力支持。

🚀 快速开始

本项目提供了便捷的安装和使用方式，助你快速搭建 MCP 服务器。

📦 安装指南

你可以通过以下两种方式安装该包：

• 使用 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 文件。