WisdomForge

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

特性

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

预备条件

• Node.js 20.x或更高版本（推荐长期支持版本）
• 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=3

5. 构建项目：

npm run build

AI IDE集成

Cursor AI IDE

在您的~/.cursor/mcp.json或.cursor/mcp.json文件中添加以下配置：

{
  "mcpServers": { 
    "wisdomforge": {
      "command": "/bin/zsh",
      "args": [
        "/path/to/wisdomforge/run-wisdomforge-mcp.sh"
      ]
    }
  }
}

替换配置中的以下占位符：

• 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，请在启动Cursor之前运行nvm use --lts以确保使用正确的Node.js版本。

Claude Desktop

在Claude的设置中添加以下配置：

{
  "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"
    }
  ]
}