🚀 记忆 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"]
}
}
}
🔧 开发流程
若你想参与项目开发，可按以下步骤操作：
- 克隆仓库：
git clone https://github.com/estav/python-memory-mcp-server.git
cd python-memory-mcp-server
- 创建虚拟环境并安装依赖项：
uv venv
source .venv/bin/activate
uv pip install -e ".[test]" # 包含测试依赖
- 运行测试：
pytest # 运行所有测试
pytest -v # 以详细输出运行
pytest -v --cov # 生成覆盖率报告
- 在本地运行服务器：
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 文件。