Firmament Open Brain

Firmamentチームのための共有「コンテキスト・ブレイン」です。OB1 に触発されつつ、Railway向けに軽量に再構築しました。PostgresをバックエンドにしたMCP（Model Context Protocol）サーバーで、各ユーザーにはプライベートなメモリストアが割り当てられ、Claude Desktop、Claude Code、claude.ai、CursorなどのAIツール間で利用できます。記憶はユーザーごとに分離されており、あなたのトークンは自分の記憶しか見えません。

仕組み

• Railwayサービス1つ（このNodeアプリ）＋Railway Postgres 1つ。

• 各ユーザーは個人用トークンを取得します。MCP URLは https://<host>/mcp/<token> です。

• すべての記憶の読み書きは、そのトークンが解決されるユーザーにスコープされます。トークンはハッシュ化（SHA-256）した状態で保存されます。

• 検索はPostgresの全文検索を使用し、部分一致にフォールバックします。embedding APIキーは不要です。

Related MCP server: LedgerMem MCP Server

公開されているMCPツール

クライアントの接続

Claude Code:

claude mcp add --transport http openbrain https://<host>/mcp/<your-token>

Claude Desktop / claude.ai: 設定 → コネクタ → カスタムコネクタを追加 → https://<host>/mcp/<your-token> を貼り付けます。

Cursor: 設定 → MCP → サーバーを追加し、種類を http にして、同じURLを指定します。

あとは普通に話しかけるだけです：「...を覚えておいて」／「...について何を知っていますか？」。セッションの開始時に「に関するコンテキストを自分のオープンブレインで確認して」と言う習慣をつけるとよいでしょう。

管理者（ユーザーの発行）

ADMIN_TOKEN 環境変数が必要です。Bearerトークンとして渡してください。

# create a user (returns their token + MCP URL — shown only once)
curl -X POST https://<host>/admin/users \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Jack Wright"}'

# list users
curl https://<host>/admin/users -H "Authorization: Bearer $ADMIN_TOKEN"

# delete a user (and all their memories)
curl -X DELETE https://<host>/admin/users/<id> -H "Authorization: Bearer $ADMIN_TOKEN"

デプロイ（Railway）

アプリサービスに設定する環境変数：

• DATABASE_URL — Railway Postgresを参照

• ADMIN_TOKEN — 長いランダム文字列（管理者APIの認証）

• DATABASE_SSL — Railwayのプライベートネットワーク経由で接続する場合は false に設定

このディレクトリから railway up でデプロイします。スキーマは起動時に自動生成されます。

セキュリティに関する注意

• トークンはURLに含まれます。そのためコピー＆ペースト1回で接続でき、少人数の信頼できるチームでは許容範囲ですが、URLはパスワードと同じように扱ってください。共有したり、グループチャットに貼り付けたりしないでください。

• トークンを失くした場合 → ユーザーを削除して新しいユーザーを発行します（記憶はユーザー行に紐づいているため、ユーザーを削除するとその記憶も削除されます。必要なら先にエクスポートしてください）。