Skip to main content
Glama
deenesjakoruzh
2loch-ness6

@mempalace/mcp-dev

by 2loch-ness6
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

@mempalace/mcp-dev

AIコーディングアシスタントに、コードベースに関する根拠に基づいたブランチスコープのコンテキストを提供するMCP（Model Context Protocol）サーバーです。MemPalaceによるセマンティックコード検索、Git変更追跡、永続的な変更台帳、TypeScript/Jest開発ライフサイクルツール、および構造化された機能作業のための組み込みの Project Tracks (Conductor) メソドロジーを提供します。

機能

機能

説明

セマンティックコード検索

MemPalace埋め込みを介した、インデックス化されたコードベースに対する自然言語クエリ

ブランチコンテキスト

現在のブランチ、SHA、最近のコミット — 常に状況を把握

変更台帳

AI支援によるすべての変更を完全な来歴とともに記録する追記型JSONLログ

開発ライフサイクル

MCPクライアント内から tsc 型チェックとJestテストを実行

Git diff

完全またはファイルスコープのdiff出力

Project Tracks

マークダウンベースの機能トラック（計画/仕様/インデックス/メタデータ）の作成と管理

前提条件

  • Node.js ≥ 18

  • Python ≥ 3.9 ( MemPalace がインストールされていること)

  • 対象となるGitリポジトリ

MemPalaceのインストール

pip install mempalace
# or from the fork with exclude-patterns support:
pip install git+https://github.com/2loch-ness6/mempalace@feat/exclude-patterns-config

クイックスタート

1. MCPサーバーのインストール

npm install -g @mempalace/mcp-dev

または、インストールせずに npx を使用します：

npx @mempalace/mcp-dev

2. 環境変数の設定

export MCP_REPO_DIR=/path/to/your/repo        # defaults to process.cwd()
export MCP_PALACE_DIR=~/.mempalace/active      # MemPalace data directory
export MCP_PALACE_WING=code                    # wing name (namespace) for your repo
export MEMPALACE_PYTHON=python3                # python binary with mempalace installed

3. コードベースのインデックス化

mempalace --palace ~/.mempalace/active mine /path/to/your/repo --wing code --mode projects

4. MCPクライアント設定への追加

Claude Desktopの場合 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mempalace-mcp-dev": {
      "command": "npx",
      "args": ["@mempalace/mcp-dev"],
      "env": {
        "MCP_REPO_DIR": "/path/to/your/repo",
        "MCP_PALACE_DIR": "/home/you/.mempalace/active",
        "MCP_PALACE_WING": "code",
        "MEMPALACE_PYTHON": "python3"
      }
    }
  }
}

環境変数

変数

デフォルト

説明

MCP_REPO_DIR

process.cwd()

Gitリポジトリルートへの絶対パス

MCP_PALACE_DIR

~/.mempalace/active

MemPalaceデータディレクトリ

MCP_PALACE_WING

code

パレス内のウィング（名前空間）名

MCP_LEDGER_PATH

<repo>/.mcp-dev/ledger.jsonl

変更台帳ファイルへのパス

MCP_TRACKS_DIR

<repo>/conductor/tracks

プロジェクトトラックフォルダを含むディレクトリ

MEMPALACE_PYTHON

python3

Pythonバイナリ (mempalace がインストールされていること)

MCPツールリファレンス

コード検索

ツール

説明

search_code

インデックス化されたコードベースに対するセマンティック検索。query (文字列) およびオプションの scope (ルーム名) と limit (整数、デフォルト10) を受け付けます

mine_changed_files

前回のGitコミット以降に変更されたファイルを再インデックス化します。検索を最新に保つために編集後に呼び出してください

ブランチ & Git

ツール

説明

get_branch_context

現在のブランチ、SHA、短いSHA、および最後の5つのコミットメッセージを返します

get_changed_files

HEAD~1（または指定されたベース参照）と比較して変更されたファイルを、追加/変更/削除ステータスとともに返します

get_git_diff

完全なdiff出力。スコープ指定用にオプションの base 参照と filePath を使用可能

変更台帳

ツール

説明

record_change

台帳にエントリを追加します（影響を受けたファイル、説明、理由、タグ、オプションのトラックリンク）

read_ledger

最近の台帳エントリを読み取ります。オプションの limit (デフォルト20) と branch フィルターを使用可能

開発ライフサイクル

ツール

説明

run_typecheck

サービスディレクトリで tsc --noEmit を実行します。ファイル/行/列/コードを含む構造化されたエラーを返します

run_tests

サービスディレクトリでJestを実行します。合格/不合格数と構造化された失敗の詳細を返します

Project Tracks (Conductor)

ツール

説明

list_tracks

すべてのライブトラック（plan.md を含むディレクトリ）を一覧表示します

get_track_plan

トラックの plan.md を読み取ります

update_track_plan

トラックの plan.md を上書きします

get_track_spec

トラックの spec.md を読み取ります

update_track_spec

トラックの spec.md を上書きします

get_track_index

トラックの index.md を読み取ります

update_track_index

トラックの index.md を上書きします

create_track

4つのファイルすべてを含む新しいトラックディレクトリを構築します

Project Tracksメソドロジー (Conductor)

Project Tracksは、軽量なファイルベースの機能管理システムです。各 トラック は、最大4つのファイルを含むディレクトリです：

conductor/tracks/
└── my-feature-20260501/
    ├── plan.md       ← living task list; the status source of truth
    ├── spec.md       ← technical spec, design decisions, acceptance criteria
    ├── index.md      ← short summary and linked resources
    └── metadata.json ← machine-readable metadata (id, owner, status, dates)

ルール:

  • ディレクトリは plan.md を含む場合にのみライブトラックとみなされます。

  • plan.md は常にディスクからライブで読み書きされます（MemPalace経由ではなく、陳腐化しません）。

  • トラックスラッグは [a-zA-Z0-9][a-zA-Z0-9_-]* (最大100文字) に一致する必要があります。

新しいプロジェクトでのトラックのブートストラップ:

# Create the tracks directory
mkdir -p conductor/tracks

# Use the MCP tool to scaffold a track
# (or copy from templates/track/ in this package)

テンプレートファイルは、手動構築用に templates/track/ に含まれています。

MemPalace設定 (mempalace.yaml)

MCP_REPO_DIR のルートに mempalace.yaml を配置して、ファイルのインデックス方法を制御します。汎用的な例が mempalace.yaml.example に提供されています。

主要セクション:

  • wing — MCP_PALACE_WING と一致する必要があります

  • exclude_patterns — マイニング中にスキップするgitignore構文のパターン

  • rooms — 検索スコープ用のセマンティックルーティングルール（キーワード → ルーム名）

開発

git clone https://github.com/your-org/mempalace-mcp-dev
cd mempalace-mcp-dev
npm install
npm run build
npm test

貢献ガイドラインについては CONTRIBUTING.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/2loch-ness6/mempalace-mcp-dev'

If you have feedback or need assistance with the MCP directory API, please join our Discord server