Promem-MCP

Project Memory MCP — AIコーディングエージェントのための永続的なプロジェクトコンテキスト。DIP-ROによって構築されました。

pip install promem-mcp

データベース不要。クラウド不要。デーモン不要。手動メモリ管理不要。

ContextMCPは、ローカルファースト、MCPネイティブのコンテキストランタイムであり、AIコーディングエージェントに永続的なプロジェクト理解（アーキテクチャ、ルール、決定、規約、環境インテリジェンス、Gitコンテキスト）を提供し、繰り返しの説明やコンテキストの無駄を排除します。

Quick Start

pip install promem-mcp

次に、ContextMCPをAIコーディングクライアントに登録します:

# See which clients are detected
promem config

# Auto-configure a specific client (with backup + merge)
promem config cursor
promem config claude-code
promem config claude-desktop
promem config vscode

または、クライアントのMCP設定に手動で追加します:

{
  "mcpServers": {
    "contextmcp": {
      "command": "contextmcp",
      "args": []
    }
  }
}

VS Codeの注意: VS Codeは"servers"キーを使用し、"mcpServers"ではありません。正しい形式を得るにはpromem config vscodeを実行してください。

これで完了です。AIコーディングエージェントが永続的なプロジェクトコンテキストを持つようになりました。

How It Works

Features

• ゼロセットアップストレージ — SQLiteデータベースがOS適切なディレクトリに自動作成されます

• 自動プロジェクト検出 — 言語、フレームワーク、パッケージマネージャー、テストフレームワーク

• 永続メモリ — ルール、決定、規約、環境情報、Gitインテリジェンス

• トークン効率的な検索 — トークン予算によるFTS5検索、関連コンテキストのみを返す

• 出所追跡 — すべてのメモリがその出所と信頼度を把握

• シークレット編集 — APIキー、トークン、パスワードは決して保存または返されない

• プロジェクト分離 — プロジェクトメモリが他のプロジェクトに漏洩しない

• 古いコンテキスト検出 — 現在のプロジェクト状態と矛盾するメモリにフラグを付ける

• 矛盾検出 — 競合するプロジェクトルールを識別

• セッション継続性 — エージェント/セッション間の切り替えのためのハンドオフサマリー

• Gitインテリジェンス — 最近のコミット、変更ファイル、TODO/FIXME

• 環境診断 — Pythonバージョン、venv、.envの完全性、Docker

• ローカルファースト — ネットワークリクエストなし、クラウドなし、外部サービスなし

MCP Tools

CLI

contextmcp --version        # Version
promem status           # Project + storage status
promem doctor           # Health checks
promem stats            # Usage statistics
promem search "query"   # Search context
promem memory list      # List memories
promem decision "text"  # Save a decision
promem privacy          # Privacy info
promem config           # Client configuration
promem repair           # Rebuild index, optimize DB
promem reset            # Delete all data (with confirmation)

Client Support

どのクライアントも真のゼロコンフィグ自動登録をサポートしていません。ContextMCPはインストール済みクライアントを検出し、設定の書き込み（バックアップ＋マージ付き）を提案し、正確なコピーペースト用スニペットを提供します。

Privacy

• ローカルのみ — ネットワークリクエストなし

• プロジェクト内容はアップロードされません

• シークレット編集 — 保存も返却もされません

• クラウド依存なし

promem privacy

Storage Location

ContextMCPはプロジェクトローカルストレージを使用します — 集中型OSディレクトリなし、無駄なスペースなし。

各プロジェクトは独自の.contextmcp/contextmcp.dbを持ちます。ストレージはプロジェクトと共に移動します。グローバルストレージの肥大化はありません。

.contextmcp/を.gitignoreに追加してください（ContextMCPの無視パターンにデフォルトで含まれています）。

必要に応じてCONTEXTMCP_DATA_DIR環境変数で上書きします。

Installation

# pip
pip install promem-mcp

# uv
uv add contextmcp

# pipx (global CLI)
pipx install contextmcp

venv、virtualenv、uv、pipx、システムPythonで動作します。

Development

git clone https://github.com/contextmcp/contextmcp.git
cd contextmcp
pip install -e ".[dev]"
pytest

License

MIT