Wisdomforge

🚀 WisdomForge

WisdomForge是一個強大的知識管理系統，它能夠從經驗、見解和最佳實踐中鍛造智慧。該系統使用Qdrant向量數據庫，實現了高效的知識存儲與檢索。

🚀 快速開始

WisdomForge是一款強大的知識管理系統，藉助Qdrant向量數據庫實現高效的知識存儲與檢索。以下是使用該系統的快速開始步驟。

✨ 主要特性

• 智能知識管理與檢索：可對知識進行智能管理，並能快速檢索所需內容。
• 支持多種知識類型：涵蓋最佳實踐、教訓、見解、經驗等多種知識類型。
• 可配置的數據庫選擇：通過環境變量，可靈活選擇數據庫。
• 高效的嵌入生成：使用Qdrant內置FastEmbed進行高效的嵌入生成。
• 領域知識存儲與檢索：能夠對特定領域的知識進行存儲和檢索。
• 可部署到Smithery.ai平臺：支持將系統部署到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"
    }
  }
}

確保項目路徑正確，並已啟動服務器。