cosmos-mcp

cosmos-mcp

ひとつの外部記憶。すべてのエージェントに。
_{Cosmos グラフ用の MCP サーバー。}

---

利用する AI はどれも、あなたに関する独自の非公開グラフを構築しています。Claude にも、ChatGPT にも、Cursor にもあります。それらは互いに連携せず、あなた自身のものでもありません。

Cosmos はその構図を逆転させます。ナレッジグラフをひとつの場所に置き、MCP 対応クライアント（Claude Code、Claude Desktop、Cursor、Codex、Zed、Continue）が同じグラフを読み書きします。エージェントがあなたについて長く役立つ情報に気づくと、その情報はグラフに保存されます。ツールを切り替えても、グラフは引き継がれます。統合レイヤーを所有するのはプラットフォームではなく、ユーザーです。

あなたが持ち歩くのは、あなた自身の .polarity ファイルです。

1 行でインストール

curl -fsSL https://mcp.polarity-lab.com/install.sh | sh

macOS では、MCP サーバーをインストールし、cosmos-mcp:// を登録して、Claude Desktop、Claude Code、Cursor、Codex、Zed、Continue を設定します。さらに Cosmos Sync.app をインストールし、iMessage、ブラウザーの履歴、カレンダー、Claude Desktop のトランスクリプト、シェル履歴をバックグラウンドで同期できるようにします。Linux と Windows では、MCP サーバーの設定のみをインストールします。

変更を加える前に内容を確認する場合：

curl -fsSL https://mcp.polarity-lab.com/install.sh -o install.sh
bash install.sh --dry-run
bash install.sh

プロビジョニング

pmk_… キーを Mac に追加する方法は 2 つあります。

自動。 cosmos.polarity-lab.com/connectors にサインインし、「open in cosmos-mcp」をタップします。OS が 1 回限りのハンドラーを開き、キーをシステムキーチェーンに書き込みます。キーの生データが表示されることはありません。

このディープリンクを機能させるには、URL スキームを一度登録します。

npx -y @polarity-lab/cosmos-mcp install-handler

これにより、~/Library/Application Support/cosmos-mcp/ に小さな .app が配置され、Launch Services に cosmos-mcp:// が登録されます。macOS のみで利用できます。

手動。 pmk_… キーをすでに持っている場合、またはハンドラーをインストールしたくない場合：

npx -y @polarity-lab/cosmos-mcp provision pmk_xxx

CLI はキーを cosmos に照会して検証し、macOS のシステムキーチェーンにサービス cosmos-mcp-key として保存します。以降の imessage sync、browser sync、calendar sync の呼び出しでは、キーチェーンからキーを読み込みます。環境変数は不要です。

iMessage へのアクセスを確認する。

npx -y @polarity-lab/cosmos-mcp imessage probe

フルディスクアクセスが許可されているか確認し、表示可能なチャットの数を報告します。EACCES メッセージが表示された場合は、「システム設定」>「プライバシーとセキュリティ」>「フルディスクアクセス」を開き、ターミナル（または CLI を実行するアプリ）を追加してください。

CI。 環境変数に COSMOS_TOKEN=pmk_… を設定します。キーチェーンよりも優先されるため、既存のパイプラインは変更せずに引き続き動作します。

MCP の手動設定

インストーラーは一般的なクライアントを設定します。クライアントを手動で接続する場合は、パッケージを指定してください。

npx -y @polarity-lab/cosmos-mcp init

ブラウザーが開きます。cosmos.polarity-lab.com にサインインして、ユーザーごとのキーを承認すると、トークンが ~/.config/cosmos-mcp/token（0600）に保存されます。次に、任意の MCP クライアントでそのトークンを指定します。

{
  "mcpServers": {
    "cosmos": {
      "command": "npx",
      "args": ["-y", "@polarity-lab/cosmos-mcp"]
    }
  }
}

この設定は、Claude Desktop の場合は ~/Library/Application Support/Claude/claude_desktop_config.json に、Cursor の場合は .cursor/mcp.json に、その他のクライアントの場合はそれに相当するファイルに追加します。

得られるもの

ツールは11個で、読み取り用が4個、書き込み用が7個です。

読み取り

ツール	呼び出し	返される内容
polarity_whoami	GET /api/polarity/whoami	関連付けられたユーザーとスコープ。低コストのプローブです。
polarity_export	POST /api/polarity/export	個人グラフ全体を polarity/v1 JSON として返します。
polarity_get_graph	GET /api/polarity	エンティティ（user、cosmos、polarity）でスコープされたグラフビューです。
polarity_ask	POST /api/polarity/ask	グラフ全体から合成した自然言語の質問への回答です。

書き込み

ツール	呼び出し	動作
polarity_observe	POST /api/polarity/observe	自由形式の観察内容です。抽出はCosmosが行います。
polarity_record_event	POST /api/polarity/observe (kind=event)	ある時点で起きた出来事です。
polarity_record_preference	POST /api/polarity/observe (kind=preference)	好み、苦手なこと、作業スタイルのルールです。
polarity_capture_turn	POST /api/polarity/capture-turn	ユーザーとアシスタントのやり取り全体をCosmosに渡します。1回の呼び出しですべての永続的な観察内容を抽出します。複数回の polarity_observe 呼び出しより優先して使用してください。
polarity_reconstruct_hours	POST /api/polarity/reconstruct-hours	生活時間の記録をスキルマップの空に保存します（ユーザーごと）。実質的な作業の後に、Cursor/Cosmos IDEから使用してください。
polarity_dump	POST /api/polarity/dump	場所にひも付いた短いメッセージです。
polarity_checkin	POST /api/polarity/checkin	経由地点でチェックインします。同じ場所にいる人の検出が行われます。
polarity_declare	POST /api/polarity/declare	経由地点に今後いることを宣言します。

ソース

MCP サーバーはグラフに書き込む方法の1つです。Cosmosは、メモを保存している場所を問わずソースページを受け入れ、MCPの読み取りツールはすべての内容を同じビューで参照します。

ソース	接続方法	取り込まれる内容
iMessage	ローカルCLI：npx -y @polarity-lab/cosmos-mcp imessage sync。Macのみ。先にターミナルにフルディスクアクセスを許可してください。	chat.dbから、テキスト内容を含む会話のやり取りが取り込まれます。グラフには会話の重みでサイズが決まり、ローカルのAddressBookを使って名前が付けられ、実際のメッセージのタイムスタンプで日付が設定された人物ノードが表示されます。
Claude Desktop	ローカルCLI：npx -y @polarity-lab/cosmos-mcp claude-desktop sync。~/.claude/projects/にあるClaude Codeのセッショントランスクリプトを読み込みます。	Claude Codeの各セッションがスレッドノードになり、ユーザーとアシスタントのやり取りが全文付きで conversation_turns に取り込まれます。ツール使用に関する処理情報はクライアント側で除去されます。
シェル履歴	ローカルCLI：npx -y @polarity-lab/cosmos-mcp shell-history sync。バイトオフセットのウォーターマークを使って ~/.zsh_history を読み込みます（利用できない場合はbash/fishにフォールバックします）。	各同期ウィンドウは、shell-history:<sync-iso> をキーとし、本文にコマンドを改行で連結した1つの source_page として取り込まれます。簡単なコマンド（ls、cd ..、1文字のみのコマンド）と連続する重複はクライアント側で除外されます。
Notion	cosmos.polarity-lab.com/connectorsでOAuth接続します。共有するページとデータベースを選択してください。	Notionの各ページはNotion IDをキーとする source_page ノードになり、毎日の同期で最新の状態に保たれます。
Obsidian	コミュニティプラグイン：polarity-lab/obsidian-cosmos。pmk_キーを貼り付け、Vaultを指定してください。	各ノートはVaultからの相対パスをキーとする source_page ノードになります。タグとWikiリンクはエッジとして解決されます。
MCPクライアント	このパッケージです。	観察内容、イベント、好み、場所付きのメッセージ、チェックイン、宣言です。
直接API	キーを使って POST /api/polarity/observe を呼び出します。	観察内容として表現できるものなら、何でも取り込めます。

変更されていないページはサーバー側でスキップされるため、更新の少ないVaultや安定したNotionワークスペースを再同期しても、ほとんどコストはかかりません。iMessageの同期も増分方式で、最後に成功した実行時点をウォーターマークとして記録するため、新しいメッセージが届くまでは再実行しても何も行われません。

iMessage の同期

cosmos-mcp には、ローカルの Messages データベースを読み取り、すべての会話をグラフに取り込む imessage サブコマンドが用意されています。

# default: incremental sync, 90-day window on first run
npx -y @polarity-lab/cosmos-mcp imessage sync

# re-sync the original 90-day window regardless of watermark
npx -y @polarity-lab/cosmos-mcp imessage sync --backfill

# pull everything since a specific date
npx -y @polarity-lab/cosmos-mcp imessage sync --since 2024-01-01

# check what the last run did
npx -y @polarity-lab/cosmos-mcp imessage status

3 つのルールで構成されたノイズ除去フィルター（返信不可の送信者、ショートコードの番号、やり取りの少ない連絡先）により、グラフを整理した状態に保ちます。AddressBook が電話番号とメールアドレスを実際の連絡先名に解決します。読み取りは Mac 上でローカルに行われ、抽出・正規化されたターンのみが、お客様のアカウントである cosmos グラフに送信されます。

Claude Desktop の同期

cosmos-mcp には、Claude Code のセッショントランスクリプトを監視し、各ターンをグラフに取り込む claude-desktop サブコマンドが用意されています。デスクトップのチャット画面自体は会話をサーバー側に保存するため、リアルタイムで監視できるディスク上のソースは ~/.claude/projects/<encoded-cwd>/<session-id>.jsonl です。

# default: incremental, watermarked per session
npx -y @polarity-lab/cosmos-mcp claude-desktop sync

# limit to recent activity
npx -y @polarity-lab/cosmos-mcp claude-desktop sync --since 2026-05-01

# scan and report without shipping
npx -y @polarity-lab/cosmos-mcp claude-desktop sync --dry-run

# see what the last run did
npx -y @polarity-lab/cosmos-mcp claude-desktop status

ツール使用ブロック、フックの処理、サブエージェント（サイドチェーン）のターンはクライアント側で取り除かれ、ユーザーとアシスタントがやり取りした表示テキストのみが送信されます。各セッション ID は、(user_id, "claude-desktop", session_id) をキーとする独自のスレッドノードになります。

バックグラウンド同期（macOS）

cosmos-mcp daemon install を実行すると、4 時間ごとに動作し、ブラウザー、iMessage、カレンダー、claude-desktop、シェル履歴の各同期を連続して実行する LaunchAgent が配置されます。このエージェントは、npm パッケージに同梱され、インストール時に ~/Applications/Cosmos Sync.app にコピーされる、署名・公証済みの Cosmos Sync.app バンドルを起動します。

npx -y @polarity-lab/cosmos-mcp daemon install

インストール後、バンドルに対してフルディスクアクセスを一度許可してください。

1. システム設定 → プライバシーとセキュリティ → フルディスクアクセスを開きます
2. ＋をクリックし、~/Applications/Cosmos Sync.app をリストにドラッグします
3. その横にあるチェックボックスがオンになっていることを確認します
4. cosmos-mcp daemon kick を実行して、今すぐ同期を開始します

ブラウザーの同期には、この手順は必要ありません。iMessage とカレンダーは、ユーザー側で TCC により保護された SQLite データベースを読み取るため、フルディスクアクセスが必要です。cosmos-mcp daemon status は、署名チーム ID、plist とランナーのパス、launchd にエージェントが読み込まれているかどうかを報告します。cosmos-mcp daemon uninstall は、plist、ランナー、~/Applications/Cosmos Sync.app を削除します。

設定

環境変数	デフォルト	設定する場合
COSMOS_URL	https://cosmos.polarity-lab.com	cosmos API エンドポイントを上書きします。
COSMOS_TOKEN	（キーチェーンから取得）	CLI サブコマンド用のユーザーごとの pmk_... キーです。macOS キーチェーンのエントリーより優先されます。CI ではこれを設定してください。
COSMOS_MCP_KEY	（トークンファイルから取得）	ユーザーごとの pmk_... キーです。後方互換性のために使用されます。
COSMOS_USER_ID	（トークンファイルから取得）	Polarity のユーザー ID です。
COSMOS_SYSTEM_KEY	（未設定）	シングルテナントモードです。X-MCP-Key の代わりに X-System-Key を送信します。COSMOS_USER_ID が必要です。ユーザーごとのキーが導入される前の内部テスト用です。

3 行で伝える Cosmos

AI ツールはそれぞれ、あなたについての情報を断片的に把握しています。それらを共有することは許されていません。 Cosmos は、それらの共有を可能にするレイヤーです。鍵はあなたが持ちます。グラフは持ち運べます。 離れるときも、その理解を持っていけます。

ライセンス

MIT。