Vault — 小さな個人用MCPサーバー

メモとブックマークを1つのSQLiteファイルに保存し、5つのツールを通じてClaudeに公開します： add_note、add_bookmark、search_notes、list_notes、delete_note。

1. uvのインストール（初回のみ）

PowerShellを開いて、以下を実行します：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

実行後、ターミナルを閉じて再度開き、uvがPATHに通っていることを確認してください。

Related MCP server: MCP Notes Server

2. プロジェクトのセットアップ

このフォルダを永続的な場所（例：C:\Users\<あなたのユーザー名>\mcp-vault）に解凍します。その後、そのフォルダ内で以下を実行します：

cd C:\Users\<you>\mcp-vault
uv sync

これにより仮想環境が作成され、fastmcpがインストールされます。

3. スタンドアロンでのテスト（Claude Desktopに接続する前）

uv run fastmcp dev server.py

これにより、ブラウザでMCPインスペクタが開きます。Toolsタブをクリックし、add_noteにテキストを入力して呼び出し、次にlist_notesを試してみてください。メモが表示されるはずです。確認が終わったらCtrl+Cで停止します。

4. Claude Desktopへの接続設定

以下のファイルを開くか作成します：

%APPDATA%\Claude\claude_desktop_config.json

mcpServersの下にvaultエントリを追加します。ファイルに既に他のサーバーが含まれている場合は、ファイル全体を置き換えずに、このキーをそれらと並べて追加してください。

{
  "mcpServers": {
    "vault": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<you>\\mcp-vault",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

C:\\Users\\<あなたのユーザー名>\\mcp-vaultを実際のフォルダのパスに置き換えてください。例のように二重バックスラッシュを使用します。

5. Claude Desktopの再起動

完全に終了（ウィンドウを閉じるだけでなく、タスクトレイアイコンを右クリック→終了）してから再度開きます。チャットボックス内のツールアイコンを探してクリックすると、5つのvaultツールが表示されるはずです。

6. 試してみる

• 「メモを保存：パスポートの更新、タグはtodo」

• 「このリンクを保存：https://example.com、タイトルはExample、タグはreference」

• 「タグがtodoのものを表示」

• 「パスポートについてメモを検索」

• 「メモ1を削除」

データはserver.pyと同じディレクトリにあるvault.dbに保存されます。これは単なるSQLiteファイルなので、SQLiteブラウザで直接開いて確認することもできます。

スクリーンショット

注意事項

• 各ツールのdocstringは、Claudeがいつそのツールを呼び出すかを判断するために読み取るものです。ツールの名前を変更したり用途を変えたりする場合は、docstringを正確に保ってください。これがインターフェースのすべてです。

• Claude Desktopがサーバーを認識しない場合は、%APPDATA%\Claude\logs\でエラーを確認してください。通常は設定ファイルのパスが間違っていることが原因です。