Wisdomforge

🚀 WisdomForge

強力な知識管理システムで、経験、洞察、ベストプラクティスから知恵を鍛えることができます。Qdrantベクトルデータベースを使用して、効率的な知識の保存と検索を実現します。

🚀 クイックスタート

WisdomForgeは、経験、洞察、ベストプラクティスから知恵を鍛える強力な知識管理システムです。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: HTTPサーバーモードを有効にするにはtrueに設定します
• PORT: ローカル開発で使用するポート番号（デフォルト: 3000）。Smitheryクラウドデプロイでのみ使用されます。

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  # ローカル開発でのみ使用

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がインストールされていることを確認してください。

Claude Desktop

Claude Desktopで以下の設定を行います：

{
  "config": {
    "path": "your_project_path",
    "server": {
      "command": "npm start"
    }
  }
}

プロジェクトパスが正しく、サーバーが起動していることを確認してください。