Qdrant MCP Server

基本能力

产品定位

wisdomforge 是一个支持 Qdrant 和 Chroma 向量数据库的服务器实现，专注于领域知识的存储和检索。

核心功能

• 支持 Qdrant 和 Chroma 向量数据库
• 通过环境变量配置数据库选择
• 使用 Qdrant 内置的 FastEmbed 进行高效的嵌入生成
• 领域知识的存储和检索
• 文档文件存储与元数据管理
• 支持 PDF 和 TXT 文件格式

适用场景

• 知识管理系统
• 文档检索系统
• 领域知识存储与检索
• AI IDE 集成（如 Cursor AI IDE 和 Claude Desktop）

工具列表

1. store_knowledge：将领域特定知识存储到向量数据库中。
2. retrieve_knowledge_context：从向量数据库中检索相关的领域知识。

常见问题解答

1. Node.js 版本问题：确保使用 Node.js LTS 版本（nvm use --lts）。
2. 环境变量问题：验证环境变量是否正确设置。
3. 数据库连接问题：检查 Qdrant/Chroma 的连接性。
4. Qdrant 实例配置问题：确保 Qdrant 实例正确配置。

使用教程

使用依赖

• Node.js 20.x 或更高版本（推荐 LTS）
• npm 10.x 或更高版本
• Qdrant 或 Chroma 向量数据库

安装教程

1. 克隆仓库：

git clone <repository-url>
cd qdrant-mcp-server

1. 安装依赖：

npm install

1. 创建 .env 文件：

cp .env.example .env

1. 更新 .env 文件：

DATABASE_TYPE=qdrant
QDRANT_URL=https://your-qdrant-instance.example.com:6333
QDRANT_API_KEY=your_api_key
COLLECTION_NAME=your_collection_name

1. 构建项目：

npm run build

调试方式

1. 启动服务器：

npm start

1. 开发模式（自动重载）：

npm run dev

1. 存储文档：

npm run store-doc <path-to-your-file>

1. 运行测试：

npm test

1. 代码检查：

npm run lint

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。