Vito MCP

🚀 工夫 forge

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

🚀 クイックスタート

工夫 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：HTTP サーバーモードを有効にする場合は true に設定
• 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 の設定については詳細が記載されていません。関連ドキュメントやサンプルを参照して詳細を取得することをおすすめします。