mcpField
M
Mindswap

Mindswap

ローカル
github.com/ShipOrBleedメモリ・ナレッジ725 週間前に更新
リポジトリ

Mindswap について

Mindswapは、開発者やコーディングエージェント向けのローカル優先のコンテキスト・メモリーサーバーで、セッションをまたいでプロジェクトの状態や決定事項を引き継ぎます。コマンドラインで記録や検索、引き継ぎ用ブリーフィングの作成ができ、MCP経由でAIクライアントとコンテキストを共有できます。

主な機能

  1. 01タスク、Gitの状態、決定事項の保存
  2. 02引き継ぎブリーフィングによる作業再開
  3. 03引用付きメモリー検索
  4. 04障害、前提、質問の管理
  5. 05プロジェクト用と個人用の記憶範囲
  6. 06複数マシン間での状態同期

活用シーン

  1. 01後のセッションでコーディング作業を再開
  2. 02プロジェクトの決定理由を検索
  3. 03プロジェクトをまたいで個人の好みを保持
  4. 04AIクライアントとプロジェクトコンテキストを共有

MCP 対応

mcpおよびmcp-httpコマンドを通じて、AIクライアントにプロジェクトと個人のコンテキストを提供します。MCPのインストール用コマンドも備えています。

#mcp#ai#coding-agent#developer-tools#context#memory#cli#productivity

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "mindswap": {
      "command": "npx",
      "args": [
        "-y",
        "mindswap"
      ]
    }
  }
}
起動コマンドnpx -y mindswap

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmmindswap3.3.0

ツール

4

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
focusenumいいえ重点対象："all" はコンテキスト全体、"task" は現在の作業のみ、"decisions" はアーキテクチャ上の決定、"recent" は最新の変更を示しますall | task | decisions | recent
compactbooleanいいえトークンを最適化した簡潔な形式で返します（情報は同じで、トークン数を削減）。

詳細

mindswap

npm version License: MIT

プロジェクトのコンテキストと個人用 AI メモリーをローカルに保持し、同じコンテキストを何度も説明し直さなくても、ツールが作業を続けられるようにします。

開発の背景

AI セッションは頻繁にリセットされます。mindswap は現在のタスク、決定事項、ブロッカー、引き継ぎコンテキストを保存し、次のツールがスムーズに作業を引き継げるようにします。

インストール

npm install mindswap --save-dev

クイックスタート

npx mindswap init
npx mindswap
npx mindswap doctor
npx mindswap resume
npx mindswap ask "Why did we choose JWT?"

主な機能

  • init でリポジトリをセットアップし、既存の AI コンテキストをインポートします
  • save で現在のタスク、git の状態、決定事項を記録します
  • doctor でセットアップの状態と古くなったコンテキストを確認します
  • resume で簡潔なブリーフィングから作業を開始します
  • ask で引用付きのプロジェクトメモリー検索を行います
  • memory でブロッカー、前提、質問、解決事項を管理します
  • --global を使って、~/.mindswap/ にある個人用のツール間メモリーを対象にメモリーと ask の検索範囲を設定します
  • reindex でファイルベースのメモリーからローカルの SQLite 検索インデックスを再構築します
  • sync でマシン間の継続状態を共有します
  • mcp と mcp-http で同じコンテキストを AI クライアントに公開します

個人用のグローバルメモリー

MindSwap は現在、次の 2 つのローカルメモリー範囲に対応しています。

  • リポジトリメモリー：<repo>/.mindswap/
  • 個人用メモリー：~/.mindswap/

プロジェクトやツールをまたいで引き継ぎたい好みや学びには、グローバルメモリーを使用してください。

npx mindswap log "Prefer concise explanations" --type assumption --global
npx mindswap memory list --scope all
npx mindswap ask "What explanation style should we use?" --scope all
npx mindswap reindex --scope all

MCP と AI ツール

mindswap は、Claude Code、Cursor、Copilot、Codex、Windsurf、Cline、Roo、Aider、Amp、Gemini CLI、AGENTS.md ベースのワークフローなどのツール向けにコンテキストを生成します。

npx mindswap mcp-install
npx mindswap mcp-http

プロジェクトの状態

リポジトリの主なデータは .mindswap/ に保存されます。

.mindswap/
├── HANDOFF.md
├── state.json
├── decisions.log
├── memory.json
├── config.json
├── branches/
└── history/

npm パッケージ

ぜひご利用ください

mindswap がワークフローに役立ったら、リポジトリにスターを付け、引き継ぎの仕組みの改善にご協力ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。