MCP Memory Server with Qdrant Persistence

基本能力

产品定位

MCP Memory Server with Qdrant Persistence 是一个基于知识图谱和语义搜索的服务，利用Qdrant向量数据库实现高效的语义搜索功能。

核心功能

• 基于图的知识表示，支持实体和关系管理
• 文件持久化（memory.json）
• 使用Qdrant向量数据库进行语义搜索
• 支持OpenAI嵌入生成语义相似性
• HTTPS支持和反向代理兼容
• Docker支持，便于部署

适用场景

• 复杂知识表示和管理的场景
• 需要高效语义搜索的应用
• 需要持久化存储和快速检索的知识图谱应用

工具列表

实体管理

• create_entities: 创建多个新实体
• create_relations: 创建实体间的关系
• add_observations: 向实体添加观察
• delete_entities: 删除实体及其关系
• delete_observations: 删除特定观察
• delete_relations: 删除特定关系
• read_graph: 获取完整的知识图谱

语义搜索

• search_similar: 搜索语义相似的实体和关系

常见问题解答

• HTTPS连接问题：检查证书和代理设置
• Qdrant连接问题：验证Qdrant服务器URL和API密钥
• OpenAI嵌入生成问题：确保OPENAI_API_KEY正确设置

使用教程

使用依赖

1. 安装Node.js和npm
2. 安装Docker（可选）

安装教程

本地安装

1. 安装依赖：

npm install

1. 构建服务器：

npm run build

Docker安装

1. 构建Docker镜像：

docker build -t mcp-qdrant-memory .

1. 运行Docker容器：

docker run -d \
  -e OPENAI_API_KEY=your-openai-api-key \
  -e QDRANT_URL=http://your-qdrant-server:6333 \
  -e QDRANT_COLLECTION_NAME=your-collection-name \
  -e QDRANT_API_KEY=your-qdrant-api-key \
  --name mcp-qdrant-memory \
  mcp-qdrant-memory

调试方式

1. 验证服务是否运行：

docker ps

1. 检查日志：

docker logs mcp-qdrant-memory

1. 测试API调用：

curl http://localhost:port/api/health

许可证

该项目遵循 MIT 开源许可条款。