🚀 WisdomForge
WisdomForge是一个强大的知识管理系统，它能够从经验、见解和最佳实践中锻造智慧。该系统借助Qdrant向量数据库，实现了高效的知识存储与检索。
✨ 主要特性
- 具备智能知识管理与检索能力。
- 支持多种知识类型，包括最佳实践、教训、见解和经验。
- 可通过环境变量进行可配置的数据库选择。
- 使用Qdrant内置FastEmbed实现高效的嵌入生成。
- 能够进行领域知识的存储与检索。
- 可部署到Smithery.ai平台。
📦 安装指南
先决条件
- Node.js 20.x或更高版本（推荐LTS版本）
- npm 10.x或更高版本
- Qdrant或Chroma向量数据库
安装步骤
- 克隆仓库：
git clone https://github.com/hadv/wisdomforge
cd wisdomforge
- 安装依赖：
npm install
- 基于
.env.example模板创建根目录下的.env文件：
cp .env.example .env
- 在
.env文件中配置环境变量：
必要的环境变量
数据库配置
DATABASE_TYPE：选择向量数据库（qdrant或chroma）COLLECTION_NAME：向量集合名称QDRANT_URL：Qdrant实例的URL（仅在使用Qdrant时需要）QDRANT_API_KEY：Qdrant API密钥（仅在使用Qdrant时需要）CHROMA_URL：Chroma实例的URL（仅在使用Chroma时需要）
服务器配置
HTTP_SERVER：设置为true以启用HTTP服务器模式PORT：本地开发使用的端口号（默认：3000）。仅用于Smithery云部署。
示例.env配置（针对Qdrant）：
DATABASE_TYPE=qdrant
COLLECTION_NAME=wisdom_collection
QDRANT_URL=https://your-qdrant-instance.example.com:6333
QDRANT_API_KEY=your_api_key
HTTP_SERVER=true
PORT=3000 # 仅用于本地开发
- 构建项目：
npm run build
💻 使用示例
AI IDE集成
Cursor AI IDE
将以下配置添加到~/.cursor/mcp.json或.cursor/mcp.json文件中：
{
"mcpServers": {
"wisdomforge": {
"command": "npx",
"args": [
"-y",
"@smithery/cli@latest",
"run",
"@hadv/wisdomforge",
"--key",
"YOUR_API_KEY",
"--config",
"{\"database\":{\"type\":\"qdrant\",\"collectionName\":\"YOUR_COLLECTION_NAME\",\"url\":\"YOUR_QDRANT_URL\",\"apiKey\":\"YOUR_QDRANT_API_KEY\"}}",
"--transport",
"ws"
]
}
}
}
替换以下占位符：
YOUR_API_KEY：您的Smithery API密钥YOUR_COLLECTION_NAME：您的Qdrant集合名称YOUR_QDRANT_URL：您的Qdrant实例URLYOUR_QDRANT_API_KEY：您的Qdrant API密钥
⚠️ 重要提示
确保已安装Node.js正确版本。
Claude Desktop
在Claude Desktop中进行如下配置：
{
"config": {
"path": "your_project_path",
"server": {
"command": "npm start"
}
}
}
⚠️ 重要提示
确保项目路径正确，并已启动服务器。