🚀 工夫 forge
一个强大的知识管理系统，能够从经验、见解和最佳实践中锻造出智慧。使用 Qdrant 向量数据库实现高效的知识存储与检索。
✨ 主要特性
- 智能化知识管理和检索，让知识查找更高效。
- 支持多种知识类型，包括最佳实践、经验教训、见解和经验，满足多样化的知识需求。
- 可通过环境变量进行数据库选择，灵活配置存储方案。
- 使用 Qdrant 的 FastEmbed 进行高效的嵌入生成，提升知识处理能力。
- 支持域知识存储与检索，方便特定领域的知识管理。
- 可部署到 Smithery.ai 平台，便于使用和管理。
📦 安装指南
先决条件
- Node.js 20.x 或更高版本（推荐 LTS 版本）
- npm 10.x 或更高版本
- Qdrant 或 Chroma 向量数据库
安装步骤
- 克隆仓库：
git clone https://github.com/hadv/wisdomforge
cd wisdomforge
- 安装依赖项：
npm install
- 创建
.env文件：基于.env.example模板创建根目录下的.env文件。
cp .env.example .env
- 配置环境变量：将环境变量配置到
.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 # 仅用于本地开发
- 构建项目：
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 实例的 URLYOUR_QDRANT_API_KEY：您 Qdrant 的 API 密钥
⚠️ 重要提示
请确保 Node.js 已安装且
npx在 PATH 中可用。如果您使用 nvm，请运行nvm use --lts确保使用正确的 Node.js 版本。
Claude Desktop
Claude Desktop 的配置部分暂未详细说明，建议参考相关文档或示例获取更多信息。