Knowledge_vault

デモ動画

https://github.com/user-attachments/assets/4b8f11cd-bb9f-4822-b241-60ecd60bf39f

特長

• ✅ スマートな保存：タイトルとタグを自動生成します
• 🔍 強力な検索：あいまい検索とタグによる絞り込みに対応します
• 🏷️ スマートタグ：コンテンツに基づいて AI がタグを提案します
• 📊 統計情報：ナレッジベースの利用統計を表示します
• 💾 安全な保存：データはユーザーのホームディレクトリに保存されます
• 🔒 スレッドセーフ：並行アクセスに対応します

プロジェクト構成

knowledge_vault/
├── __init__.py          # Package initialization
├── server.py            # FastMCP server main file
├── storage.py           # Knowledge storage module
└── search.py            # Search functionality module
pyproject.toml           # Project configuration
start_server_new.py      # Startup script

インストール

uv で依存関係をインストールする

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Sync dependencies
uv sync

Claude Desktop を設定する

~/.config/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "knowledge-vault": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local_store_mcp",
        "run",
        "python",
        "start_server_new.py"
      ],
      "cwd": "/path/to/your/local_store_mcp",
      "description": "Local Knowledge Management MCP Server"
    }
  }
}

Claude Desktop を再起動する

設定後、Claude Desktop を再起動します。

使い方

ナレッジを保存する

Store a programming tip: Using Python list comprehension makes code more concise

ナレッジを検索する

Search for Python knowledge

統計情報を表示する

Show knowledge base statistics

利用可能なツール

1. store_knowledge - ナレッジレコードを保存します
2. search_knowledge - ナレッジレコードを検索します
3. list_recent - 最近のレコードを表示します
4. get_knowledge - ID でレコードを取得します
5. suggest_tags - タグを提案します
6. search_by_tags - タグで検索します
7. get_stats - 統計情報を取得します

データの保存

• 保存場所：~/.knowledge-vault/knowledge.jsonl
• 形式：JSON Lines
• スレッドセーフ：並行アクセス時にファイルをロックします

技術スタック

• FastMCP：MCP サーバーのフレームワーク
• Pydantic：データ検証
• uv：最新の Python パッケージ管理
• Python 3.10+：実行環境