WisdomForge

一个强大的知识管理系统，能够从经验、见解和最佳实践中锻造智慧。使用Qdrant向量数据库实现高效的知识存储与检索。

功能

• 智能知识管理与检索
• 支持多种知识类型（最佳实践、教训、见解、经验）
• 可配置的数据库选择（通过环境变量）
• 使用Qdrant内置FastEmbed进行高效的嵌入生成
• 领域知识存储与检索
• 可部署到Smithery.ai平台

先决条件

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

安装

1. 克隆仓库：

git clone https://github.com/hadv/wisdomforge
cd wisdomforge

2. 安装依赖：

npm install

3. 基于.env.example模板创建根目录下的.env文件：

cp .env.example .env

4. 在.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  # 仅用于本地开发

5. 构建项目：

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实例URL
• YOUR_QDRANT_API_KEY: 您的Qdrant API密钥

注意：确保已安装Node.js正确版本。

Claude Desktop

在Claude Desktop中进行如下配置：

{
  "config": {
    "path": "your_project_path",
    "server": {
      "command": "npm start"
    }
  }
}

确保项目路径正确，并已启动服务器。