Vito MCP

🚀 工夫 forge

一個強大的知識管理系統，能夠從經驗、見解和最佳實踐中鍛造出智慧。使用 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 已安裝且 npx 在 PATH 中可用。如果您使用 nvm，請運行 nvm use --lts 確保使用正確的 Node.js 版本。

Claude Desktop

Claude Desktop 的配置部分暫未詳細說明，建議參考相關文檔或示例獲取更多信息。