🚀 记忆 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 文件。