Memex MCP

🚀 MEMEX

「メモリ（MEMORY）」と「インデックス（INDEX）」を組み合わせた、技術ガイドや再利用可能なコンテキストの知識ベースを管理するためのモデルコンテキストプロトコル（MCP）サーバーです。

         ███╗   ███╗███████╗███╗   ███╗███████╗██╗  ██╗
         ████╗ ████║██╔════╝████╗ ████║██╔════╝╚██╗██╔╝
         ██╔████╔██║█████╗  ██╔████╔██║█████╗   ╚███╔╝ 
         ██║╚██╔╝██║██╔══╝  ██║╚██╔╝██║██╔══╝   ██╔██╗ 
         ██║ ╚═╝ ██║███████╗██║ ╚═╝ ██║███████╗██╔╝ ██╗
         ╚═╝     ╚═╝╚══════╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═╝

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   • 無料で使用可能 - 一切の制限なし                           │
│                                                                 │
│  このプロジェクトはMITライセンスの下で提供されており、可能な限り多くの開発者が利用できるようにしています。私たちは、法的義務ではなく自発的な貢献によるオープンソースを信じています。   │
│                                                                 │
│   • バグを見つけた？面白い機能を実装した？                          │
│   • イシューやプルリクエストを通じた貢献を歓迎します！                │
│                                                                 │
│  ガイドラインについてはCONTRIBUTING.mdを参照してください。                            │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

ライセンス: MIT - 任意のプロジェクトで自由に使用できます。

MEMEXは、Vannevar Bushによる1945年の先見的なメメックス（Memex）に着想を得て開発され、技術ガイドや再利用可能なコンテキストへの永続的なアクセスを提供することで、AIのメモリを拡張します。

📖 ドキュメント: USAGE.md (完全なガイド) | AGENTS.md (AIエージェント用)

✨ 主な機能

• 📚 二重知識ベース: 技術ガイドと再利用可能なコンテキストの両方を管理
  • ガイド: 段階的な実装手順
  • コンテキスト: AIとの対話におけるペルソナ、規約、プロンプト
• ✍️ 作成ツール: Claudeから直接ガイドやコンテキストを作成および更新
• 🔍 検索ツール: セマンティック検索でガイドやコンテキストを取得
• 🗑️ 削除ツール: 古い内容をクリーンアップ
• 📋 一覧ツール: 利用可能なすべてのガイドやコンテキストを閲覧
• 🔍 ベクトル検索: Ollamaの埋め込みを使用したセマンティック検索
• 🚀 Claude AI統合: MCPプロトコルを介してClaude 3.7+と互換性がある
• 📁 柔軟なストレージ: カスタムの知識ベースパスを使用し、プロジェクト間で共有可能

📦 インストール

必要条件

サポートされるオペレーティングシステム

• macOS ✅
• Linux ✅
• Windows ❌ (サポートされていません)

デフォルトの知識ベースの場所: ~/.memex/knowledge-base

最新リリースのダウンロード

curl -L https://github.com/jacquesbh/memex-mcp/releases/latest/download/memex -o memex
chmod +x memex
./memex --version

自己更新

インストール後は、以下のコマンドでMEMEXを最新バージョンに保つことができます。

./memex self-update

🚀 クイックスタート

make install                    # 依存関係のインストール
ollama pull nomic-embed-text   # セマンティック検索用のOllamaのセットアップ
make build                      # バイナリのビルド
./memex server                  # サーバーの起動

完全なセットアップ手順はUSAGE.mdを参照してください。

🔧 設定

知識ベースのパス

知識ベースの場所は、3つの方法で設定できます（優先順位: CLI > ローカル設定 > グローバル設定 > デフォルト）。

1. CLIフラグ: ./memex server --kb=/path/to/kb
2. ローカル設定: ./memex.json (プロジェクト固有)
3. グローバル設定: ~/.memex/memex.json (ユーザー全体)

設定ファイルの形式:

{
  "knowledgeBase": "/absolute/path/to/kb"
}

デフォルト: ~/.memex/knowledge-base (設定が提供されていない場合)

Claude Desktop

{
  "mcpServers": {
    "memex": {
      "command": "/absolute/path/to/memex-mcp/memex",
      "args": ["server"]
    }
  }
}

カスタムKBを使用する場合は、args配列に"--kb=/path"を追加します（設定ファイルを使用する場合はオプション）。

すべての設定オプション（OpenCode、カスタムKBなど）についてはUSAGE.mdを参照してください。

💻 使用例

MCPツール

ガイド: get_guide, list_guides, write_guide, delete_guide コンテキスト: get_context, list_contexts, write_context, delete_context

知識ベースの構造

knowledge-base/
├── guides/      # 技術的な使い方のドキュメント
├── contexts/    # AIのペルソナやプロンプト
└── .vectors/    # 埋め込みを含むSQLiteデータベース

ファイルはYAMLフロントマター付きのMarkdownを使用します。詳細はUSAGE.mdを参照してください。

ソースからのビルド

make build

これにより、すべての依存関係が含まれたスタンドアロンの./memexバイナリが作成されます。

手動ビルド:

symfony composer install
vendor/jolicode/castor/bin/castor repack --app-name=memex --logo-file=.castor.logo.php
mv memex.linux.phar memex
chmod +x memex

検証:

./memex server
./memex stats

配布: memexバイナリをコピーします。PHP 8.3以上とOllamaが必要です。

📚 ドキュメント

なぜMEMEXを使うのか？

Vannevar Bushによる1945年の知識の瞬時の保存と検索を可能にするデバイスのビジョンに着想を得て、MEMEXはガイドやコンテキストの永続的なメモリをAIに提供します。

アーキテクチャ

MEMEXはPHP 8.3以上とSymfony MCP SDKを使用して構築されており、以下の要素を利用しています。

• サービス: ガイド/コンテキストの管理、MarkdownからJSONへのコンパイル、セマンティック検索（Ollamaの埋め込み）
• ツール: 8つのMCPツール（ガイド/コンテキストの取得、一覧表示、作成、削除）
• CLI: Castorフレームワークを使用し、PHARバイナリにコンパイルされています。
• セキュリティ: 入力検証、パストラバーサル保護、1MBのコンテンツ制限

テスト

make test          # PHPUnit
make test-mcp      # MCP統合テスト (Node.jsが必要)

CI/CDの詳細についてはAGENTS.mdを参照してください。

作成者: Jacques Bodin-Hullin @ MonsieurBiz OpenCodeを使用し、少しのAIとAIの習得に多くの時間を費やして開発されました。