工夫 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 的配置部分暂未详细说明，建议参考相关文档或示例获取更多信息。