WisdomForge

一个强大的知识管理系统，能够从经验、见解和最佳实践中提炼智慧。使用Qdrant向量数据库实现高效的知识存储和检索。

功能

• 智能的知识管理和检索
• 支持多种知识类型（最佳实践、经验教训、见解、经验）
• 通过环境变量配置数据库选择
• 使用Qdrant内置的FastEmbed进行高效的嵌入生成
• 领域知识的存储和检索
• 可部署到Smithery.ai平台

前提条件

• Node.js 20.x 或更高版本（推荐LTS）
• npm 10.x 或更高版本
• Qdrant或Chroma向量数据库

安装

1. 克隆仓库：
   bash
   git clone https://github.com/hadv/wisdomforge
   cd wisdomforge

2. 安装依赖项：
   bash
   npm install

3. 在根目录下基于.env.example模板创建一个.env文件：
   bash
   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）：
env
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 # 仅用于本地开发

1. 构建项目：
   bash
   npm run build

AI IDE集成

Cursor AI IDE

将以下配置添加到您的~/.cursor/mcp.json或.cursor/mcp.json文件中：
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版本，然后再启动Cursor。

Claude Desktop

在Claude的设置中添加以下配置：
json
{
"processes": {
"knowledge_server": {
"command": "/path/to/your/project/run-mcp.sh",
"args": []
}
},
"tools": [
{
"name": "store_knowledge",
"description": "在向量数据库中存储特定领域的知识",
"provider": "process",
"process": "knowledge_server"
},
{
"name": "retrieve_knowledge_context",
"description": "从向量数据库中检索相关的领域知识",
"provider": "process",
"process": "knowledge_server"
}
]
}