🦔 Mory - パーソナルメモリMCPサーバー - Mory ドキュメント

MoryはModel Context Protocol (MCP) サーバーで、Claude DesktopやMCP対応クライアントにパーソナルメモリ機能を提供します。会話を跨いで情報を記憶し、簡単に取得できます。

ChatGPTのメモリ機能のように、Claudeに永続的なメモリ機能を追加して、よりパーソナライズされた対話を実現するMCPサーバーです。

🎯 主要機能

コアメモリシステム

✅ 永続的メモリ: 会話を跨いで個人情報を記憶・取得
✅ プライバシー重視: すべてのデータをローカル保存、クラウド依存なし
✅ カテゴリ管理: 効率的な情報整理
✅ 操作ログ: すべてのメモリ操作を監査証跡として記録

高度な検索機能 (Phase 2)

✅ 全文検索: 関連度スコアリング付きの高度なテキスト検索
✅ スマートフィルタリング: カテゴリベースの絞り込みと曖昧検索
✅ 関連度ランキング: スコアベースの検索結果順位付け

Obsidian連携 (Phase 2)

✅ ボルトインポート: Obsidianボルト全体または特定カテゴリのインポート
✅ ノート生成: メモリからテンプレートを使用したノート作成
✅ テンプレートシステム: 日記・サマリー・レポートテンプレート（日本語対応）
✅ 高度なオプション: ドライラン、カテゴリマッピング、重複処理

🚀 クイックスタート

オプション1: Docker（推奨）

git clone https://github.com/nyasuto/mory.git
cd mory

# 環境設定
cp .env.example .env
nano .env  # OpenAI API Keyを設定

# 起動
docker-compose up -d

# 動作確認
curl http://localhost:8080/api/health

📖 詳細: Docker起動ガイド

オプション2: ローカルインストール

git clone https://github.com/nyasuto/mory.git
cd mory
make build

Claude Desktop設定

Claude Desktop設定ファイルに追加：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mory": {
      "command": "/full/path/to/mory/bin/mory"
    }
  }
}

3. 基本的な使用方法

私の誕生日は1990年5月15日です。記憶してください。
→ save_memory ツールが実行されます

私について何か知ってる？
→ list_memories ツールが記憶した情報を表示します

プログラミングに関する記憶を検索して
→ search_memories ツールが関連する記憶を検索します

📖 詳細なセットアップガイド: QUICKSTART.md で詳しい手順と例を確認してください。

🔧 技術仕様: API.md で詳細なAPIリファレンスと技術仕様を確認してください。

🛠️ 利用可能なMCPツール

save_memory - カテゴリとタグ付きで情報を保存
get_memory - キーやIDで特定のメモリを取得
list_memories - オプションのカテゴリフィルタ付きでメモリを一覧表示
search_memories - 関連度スコアリング付きの高度な全文検索
obsidian_import - Obsidianボルトのノートをメモリにインポート
generate_obsidian_note - メモリからテンプレートを使用してノート生成

📋 開発状況

✅ Phase 2 完了

コアメモリ管理システム
関連度スコアリング付き高度検索
インポート・エクスポート機能付きObsidian連携
テンプレートベースのノート生成
包括的なテストスイート
Claude Desktop対応プロダクション版

📋 Phase 3 (予定)

ベクトル埋め込みによるセマンティック検索
AI による自動カテゴリ分類
スマートなコンテンツ推奨
高度な分析・インサイト機能

🔒 プライバシー・セキュリティ

ローカル専用ストレージ: すべてのデータはあなたのマシンに保存
外部依存なし: 完全にオフラインで動作
ユーザーコントロール: 何をいつ保存するかを完全制御
監査証跡: 透明性のための完全な操作ログ

🤝 コントリビューション

Moryは活発に開発中です。IssueやPull Requestを歓迎します！

開発コマンド

make build     # プロジェクトのビルド
make test      # テストの実行
make quality   # すべての品質チェック（フォーマット、リント、テスト）

詳細なガイドラインは CONTRIBUTING.md を参照してください。

🦔 なぜ「Mory」？

ハリネズミが小さな体に多くの針（記憶）を安全に収めるように、Moryはあなたの大切な記憶を安全でアクセスしやすい形で保管します。

📄 ライセンス

MIT License - このプロジェクトを自由に使用・改変してください。

現在のステータス: ✅ Phase 2 完了 - 検索・Obsidian連携機能がプロダクション対応

クイックリンク:

Mory - あなたのClaudeのためのパーソナルメモリハリネズミ 🦔

🦔 Mory - パーソナルメモリMCPサーバー