meridian

Meridian

長期にわたる AI コーディング作業のための、共有可能で構造化されたプロジェクト状態。

永続的なプロジェクト状態を管理する、ソースコードを利用できる MCP サーバーです。共有タスクログ、ピン留めされた決定事項、ヒューマン・イン・ザ・ループのキュー、段階的な引き継ぎを提供します。Claude Code、Cursor、Cline、Claude Desktop、その他あらゆる MCP クライアントで利用できます。

組み込みのエージェントメモリ（たとえば、Claude Code の CLAUDE.md ファイルや自動メモリ）は、そのエージェント向けのメモをファイルとして保存します。Meridian は、複数のセッションや異なる MCP クライアントが読み書きできる、共有可能で検索可能なプロジェクト記録を追加します。組み込みメモリを置き換えるのではなく、それと併用できます。

Meridian を選ぶ理由

AI コーディングセッションは、毎回何も知らない状態で始まります。アーキテクチャを説明し直し、制約を説明し直し、試したことを列挙し直す必要があります。作業の途中でコンテキストがいっぱいになると、詳細が失われます。これがコンテキスト負債であり、積み重なっていきます。

Meridian はセッションに共有メモリを提供します。各セッションは同じタスクログ、同じピン留めされた決定事項、同じ目標状態を参照できます。コンテキストがいっぱいになったら、新しいセッションが圧縮された引き継ぎ情報から作業を再開します。コピー＆ペーストも、一から説明し直す必要もありません。

30 秒でわかる概要

すべての AI セッションが接続するローカル MCP サーバーです。各セッションは目標状態を共有し、互いのタスクログを参照できます。また、コンテキストがいっぱいになったら、圧縮された引き継ぎ情報から作業を再開できます。

Meridian の実行方法は 2 通りです：

• セルフホスト — チームの規模を問わず、永久に無料です。クローンして、2 つのコマンドを実行するだけです。
• usemeridian.us でホスト版を利用 — 30 日間無料（カード不要）、その後は Standard が月額 20 ドルです。

クイックスタート

オプション 1 — バイナリリリース（推奨）

ビルド済みのダウンロードファイルは、すべての GitHub リリースに添付されています。 署名はありません。各リリースに、ダウンロードファイルを照合するための SHA256SUMS ファイルが含まれています。

• Windows トレイアプリ（meridian-tray.exe）：ダッシュボードサーバーを実行するシステムトレイアイコンです。トレイメニューからダッシュボードを開くを選択すると、http://127.0.0.1:7878 が開きます。
• macOS トレイアプリ（meridian-tray-mac.dmg）：同じトレイアプリです。アプリは公証されていないため、初回起動時は右クリックして > 開くを選択する必要があります。
• Linux：トレイアプリはまだありません。以下の uv インストール方法を使用してください。
• meridian.exe、meridian-linux、meridian-mac-arm64：トンネルクライアントのみです（meridian --tunnel --repo .、Pro プランと API トークンが必要です）。ダッシュボードは配信しません。

uv でダッシュボードを利用（Linux、macOS、Windows）：

uv tool install meridian-server
meridian

ダッシュボードは http://localhost:7878 で開きます。データディレクトリの既定値は ./data です。変更するには MERIDIAN_DATA_DIR を設定してください。

Pro トンネルクライアント（任意）：

meridian --tunnel --repo .

Linux / macOS（インストーラースクリプト、uv を使用）：

curl -fsSL https://usemeridian.us/install.sh | sh

Windows（PowerShell、トンネルクライアント meridian.exe をインストール）：

irm https://usemeridian.us/install-windows.ps1 | iex

オプション 2 — ソースからセットアップ（開発環境／セルフホスト）

Linux／macOS：

git clone https://github.com/meridianmcp/Meridian
cd Meridian
./install.sh
pixi run start

Windows（PowerShell）：

git clone https://github.com/meridianmcp/Meridian
cd Meridian
.\install.ps1
pixi run start

ダッシュボードは http://localhost:7878 で開きます。データは ./data/meridian.db に保存されます。

AI クライアントに接続する

Claude Code

プロジェクトのルートに .mcp.json を配置します。

ホスト型（インストール不要） — usemeridian.us/settings で API キーを生成します：

{
  "mcpServers": {
    "meridian": {
      "type": "http",
      "url": "https://usemeridian.us/mcp",
      "headers": { "Authorization": "Bearer sk_meridian_YOUR_KEY_HERE" }
    }
  }
}

セルフホスト（ソースから）：

{
  "mcpServers": {
    "meridian": {
      "command": "pixi",
      "args": ["run", "python", "-m", "meridian", "--mcp"],
      "cwd": "/absolute/path/to/Meridian"
    }
  }
}

セルフホスト（トレイアプリまたは uv のインストールがポート 7878 で稼働中）：

{
  "mcpServers": {
    "meridian": {
      "type": "http",
      "url": "http://127.0.0.1:7878/mcp"
    }
  }
}

同じ mcpServers キーを ~/.claude.json に設定すると、すべてのプロジェクトで利用できます。セルフホスト型サーバーでは API キーは不要です。MERIDIAN_PORT を設定している場合は、URL のポートを一致するように変更してください。

Cursor／Windsurf

同じ JSON スニペットを使用します。どちらのクライアントもプロジェクトのルートにある .mcp.json を読み込みます。

Claude Desktop

同じ mcpServers ブロックを次のファイルに追加します：

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

Claude Desktop を再起動してください。新しいチャットで Meridian のツールを利用できます。新しくデプロイしたツールがまだ表示されない場合は、クライアントのキャッシュを編集する前にMCP ツールサーフェスの最新状態に関するガイドに従ってください。

claude.ai ウェブ版（プランニングチャットにおすすめ）

claude.ai のコネクターから http://localhost に接続することはできません。次のいずれかを選んでください：

• ホスト型（インストール不要）： claude.ai で カスタマイズ > コネクター > カスタムコネクターを追加 に進み、URL に https://usemeridian.us/mcp を設定して、OAuth のプロンプトに従ってください。
• セルフホスト、Chrome ブリッジ： サブモジュールとして含まれている dnakov/claude-mcp を使用します：

  git clone --recurse-submodules https://github.com/meridianmcp/Meridian
  

chrome://extensions を開き、デベロッパーモード を有効にして、パッケージ化されていない拡張機能を読み込む をクリックし、extensions/claude-mcp を選択してください。ブリッジ URL を http://localhost:7878/mcp/sse に設定します。

• セルフホスト、公開 URL： サーバーを HTTPS 経由で公開し、コネクターとして https://<your-host>/mcp を追加します。

詳しい手順はブラウザーコネクターガイドをご覧ください。

ホスト型プラン（インストール不要）

usemeridian.us にサインインし、Settings → MCP client setup → Generate API key → Copy config の順に進みます。

または手動で：

{"mcpServers":{"meridian":{"type":"http","url":"https://usemeridian.us/mcp","headers":{"Authorization":"Bearer sk_meridian_YOUR_KEY_HERE"}}}}

claude.ai（ブラウザー） のユーザーは、ホスト型 Meridian に拡張機能は不要です。カスタマイズ > コネクター で https://usemeridian.us/mcp を追加してください。ブラウザーコネクターガイドをご覧ください。

サインイン後、usemeridian.us/settings で API キーを取得してください。無料プラン：30 日間、クレジットカード不要、すべての機能を利用できます。

利用できる機能

• ダッシュボード：http://localhost:7878 — セッション、タスク、スプリントボード、 スイムレーンタイムライン、HITL キュー、ピン留めされた決定事項。
• MCP ツール — start_session、log_task、claim_task、set_decision、 pin_decision、request_hitl、generate_handoff など約 50 個。
• シンボル単位の並列安全性 — claim_file で単一のクラスや関数（ast／tree-sitter で解析）を確保できます。これにより、2 つのセッションが同じファイルを安全に編集できます。確保範囲が重複する場合はブロックされ、空いているシンボルが一覧表示されます。
• ライブ作業キュー — プランナーは実行中にスプリント項目を追加できます。実行側は中断されることなく、board_change シグナルを介して次の項目の境界でその項目を取得します。
• HITL の推奨オプション — request_hitl で安全なデフォルトのオプションを指定すると、ダッシュボードで強調表示されます。Enter キーで送信し、数字キーで他のオプションを選択できます。
• GitHub ハブ（ホスト型） — Settings でリポジトリを一度接続すると、read_file、 list_files、meridian_github_search_code、git_log、meridian_github_get_commit がセッションに自動で追加されます。追加インストールは不要です。
• 段階的なハンドオフ — L0／L1／L2 の圧縮により、新しいセッションで前のセッションが中断したところから作業を再開できます。
• Webhook 受信 — LangGraph／Autogen／カスタムエージェントから同じダッシュボードにイベントを送信できます。
• あらゆる環境で動作 — Claude Code、Claude Desktop、Cursor、Windsurf、LangGraph、カスタム環境に対応します。

仕組み

> start_session(project_id="meridian", session_name="feature-x")
  ✓ session registered · sprint loaded · 12 active tasks

> get_tasks(project_id="meridian", limit=5)
  [DONE]    backend / wire decisions_pinned table
  [PENDING] frontend / add notes vtab (claimed by session-2)

> claim_task(task_id="a1f3...")
  ✓ claimed — other sessions skip this one

状態は data/meridian.db（SQLite）または MERIDIAN_DB_URL 経由の Postgres URL に保存されます。 ローカルでの利用にクラウドは不要です。

チームでの連携

MERIDIAN_DB_URL を共有 Postgres（Neon の無料枠がおすすめです）に設定します。チームメンバー全員が同じ DB に接続して各自のローカル Meridian を実行すれば、セッションを即座に共有できます。クラウド上に Meridian サーバーを立てる必要はありません。

フックによる自動チェックポイント

1 つのコマンドで Claude Code と Codex を Meridian に接続できます。セッション開始時には毎回、プロジェクトのコンテキストが自動的に挿入されます。セッション終了時には毎回、完了した作業のスナップショットを作成し、差分ハンドオフを書き込みます。

Mac/Linux:

curl -fsSL https://usemeridian.us/hooks.sh | bash

Windows:

irm https://usemeridian.us/hooks.ps1 | iex

Meridian サーバーの URL（デフォルトは http://localhost:7878）を求められた後、ブラウザーが開き、このマシンを接続します。プロジェクト ID や API トークンを貼り付ける必要はありません。~/.claude/settings.json（Claude Code）または ~/.codex/config.toml（Codex）に書き込みます。セットアップ後、セッションごとに以下が自動的に実行されます。

1. 開始時 — POST /hooks/session-start を呼び出し、目標、スプリント項目、最近のタスク、ピン留めされた決定事項を additionalContext 経由でセッションのコンテキストに挿入します。
2. 停止時 — POST /hooks/stop を呼び出し、auto_capture を実行して差分ハンドオフを書き込み、次のセッションが今回のセッションの終了地点から再開できるようにします。

start_session() を手動で呼び出す必要はもうありません。コンテキストがいっぱいになっても作業が失われることはありません。

ホステッドプラン

	Standard	Pro
価格	$20/mo	$49/mo（ウェイトリスト）
ストレージ	1 GB を含む	10 GB を含む
コンピューティング	2 CU · 100 hrs/mo	4 CU · 300 hrs/mo
Postgres の持ち込み	✓	✓
OAuth + メールのマジックリンク	✓	✓
追加ストレージ	$0.50 / GB-month	$0.50 / GB-month
サポート	メール	優先対応

30 日間の無料トライアル · カード登録不要

ライセンス

MSL-1.0 — チームの規模を問わず、ローカル利用および社内利用は無料です。Meridian を他者向けのサービスとしてホストする場合は、有料ライセンスが必要です。6 年後に MIT に切り替わります。

ライセンスに関するお問い合わせ：[email protected]

コントリビューター

@ajc3xc が開発しました