Personal Brain MCP v0.2

PostgreSQL をバックエンドに持つ、長期的な個人記憶用の MCP サーバーです。ローカルの Docker PostgreSQL とリモートの Neon PostgreSQL に対応し、Render 上でホストするための Streamable HTTP MCP エンドポイントを公開します。

MCP ツール

• get_personal_context

• save_memory

• query_personal_database — モデル生成の読み取り専用 SQL のみ

• update_context_manifest

Related MCP server: hippocampus-mcp

リモートエンドポイント

• MCP: POST /mcp (Streamable HTTP)

• ヘルスチェック: GET /health

Docker PostgreSQL を使用したローカル開発

cp .env.example .env
# Remove/comment DATABASE_URL in .env to use the local Docker settings.
docker compose up -d
npm install
npm run check
npm run dev

サーバーはデフォルトで http://localhost:10000 で待機します。

Neon / Render

Render で以下の環境変数を設定します。

DATABASE_URL=<Neon connection string>
MCP_API_KEY=<long random secret, recommended>
USER_ID=main
USER_NAME=<your display name>
USER_LANGUAGE=ko
USER_TIMEZONE=Asia/Seoul

PORT は Render によって自動的に提供されます。アプリは 0.0.0.0:$PORT にバインドします。

ビルドコマンド:

npm install && npm run build

起動コマンド:

npm start

ヘルスチェックパス:

/health

デプロイ後、MCP エンドポイントは次のようになります。

https://<your-render-service>.onrender.com/mcp

MCP_API_KEY が設定されている場合、クライアントは次を送信する必要があります。

Authorization: Bearer <MCP_API_KEY>

データベースの初期化

起動時に、アプリは必要なテーブルとインデックスがまだ存在しない場合、安全に作成します。pgvector は v0.2 ではオプションです。有効にできなくても起動は妨げられません。

セキュリティ

• .env は Git で無視されます。

• Neon の接続文字列、パスワード、API キー、トークンをコミットしないでください。

• query_personal_database は単一の SELECT/WITH クエリのみを受け付け、読み取り専用トランザクションで実行し、出力を 100 行に制限します。