Wisdomforge

🚀 WisdomForge

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"
    }
  }
}

⚠️ 重要提示

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