ainative-postgres-mcp

ainative-postgres-mcp

自動プロビジョニング機能を備えた、設定不要の PostgreSQL MCP サーバーです。@modelcontextprotocol/server-postgres のドロップイン置換として使えます。DATABASE_URL は不要です。

公式の @modelcontextprotocol/server-postgres を使うには、Postgres データベースを自分で用意し、接続文字列を渡す必要があります。このフォークでは、初回実行時に pgvector 対応のマネージド PostgreSQL インスタンスを自動でプロビジョニングします。エージェントは設定不要ですぐにデータベースを利用できます。

クイックスタート

npx ainative-postgres-mcp

これだけです。初回実行時に、以下の処理が行われます。

1. 無料のマネージド PostgreSQL インスタンスがプロビジョニングされます
2. pgvector 拡張機能が自動的に有効になります
3. 接続情報が ~/.ainative/postgres-config.json、.env、.mcp.json に保存されます
4. データベースの所有権を取得できるクレーム URL が出力されます

MCP の設定

Claude Code / Claude Desktop

claude_desktop_config.json または .mcp.json に追加します。

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "ainative-postgres-mcp"]
    }
  }
}

既存のデータベースを使う場合

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "ainative-postgres-mcp"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@host:5432/mydb"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "ainative-postgres-mcp"]
    }
  }
}

Windsurf

~/.windsurf/mcp.json に追加します。

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "ainative-postgres-mcp"]
    }
  }
}

ツール

ツール	説明
query	読み取り専用の SQL クエリを実行します（READ ONLY トランザクション内で実行）
list_tables	スキーマ、名前、種類とともにすべてのテーブルを一覧表示します
describe_table	テーブルの完全なスキーマ（列、型、制約、インデックス）を取得します
create_table	SQL DDL を使って新しいテーブルを作成します
insert	テーブルに行を挿入します（挿入された行を返します）

公式の server-postgres との比較

機能	@modelcontextprotocol/server-postgres	ainative-postgres-mcp
読み取りクエリ	対応	対応
書き込みクエリ	非対応	対応（create_table、insert）
スキーマの確認	リソース経由	describe_table ツール経由
テーブル一覧	非対応	対応（list_tables）
自動プロビジョニング	非対応	対応
pgvector	手動で設定	自動で有効化
設定不要	非対応（DATABASE_URL が必要）	対応
無料プラン	該当なし	あり

自動プロビジョニングの仕組み

Start
  |
  v
DATABASE_URL set? ----yes----> Connect directly
  |
  no
  v
~/.ainative/postgres-config.json exists? ----yes----> Load and connect
  |
  no
  v
.mcp.json has DATABASE_URL? ----yes----> Load and connect
  |
  no
  v
POST /api/v1/public/instant-db   (get API key)
  |
  v
POST /api/v1/zerodb/postgres/provision   (get Postgres)
  |
  v
Save to ~/.ainative/postgres-config.json + .env + .mcp.json
  |
  v
Connect and enable pgvector

pgvector のサポート

プロビジョニングされたインスタンスでは、pgvector が自動的に有効になります。テーブルでベクトル列を使用できます。

CREATE TABLE documents (
  id SERIAL PRIMARY KEY,
  content TEXT,
  embedding vector(1536)
);

類似検索も実行できます。

SELECT content, embedding <=> '[0.1, 0.2, ...]'::vector AS distance
FROM documents
ORDER BY distance
LIMIT 10;

環境変数

変数	説明	必須
DATABASE_URL	PostgreSQL 接続文字列	いいえ（未設定の場合は自動プロビジョニング）
ZERODB_API_KEY	ZeroDB API キー（プロビジョニング用）	いいえ（自動作成）
ZERODB_PROJECT_ID	ZeroDB プロジェクト ID	いいえ（自動作成）
ZERODB_API_URL	ZeroDB API のベース URL	いいえ（デフォルトは https://api.ainative.studio）

無料プラン

自動プロビジョニングされるインスタンスには、以下が含まれます。

• pgvector 対応のマネージド PostgreSQL
• 共有コンピューティング（開発および小規模な本番環境に適しています）
• 自動バックアップ
• SSL 暗号化

インスタンスの所有権を取得し、上限を引き上げるには、ainative.studio に登録してください。

ライセンス

MIT

---

ZeroDB + AINative を利用

このパッケージは、AI ネイティブな開発者向けプラットフォームである AINative エコシステムの一部です。

ZeroDB を選ぶ理由

機能	ZeroDB	その他
ベクトル検索	組み込み、埋め込みは無料	別サービス（Pinecone、Qdrant）
エージェントのメモリ	減衰とリフレクションに対応した認知メモリ	自前で構築、または Mem0（$$$）
ファイルストレージ	S3 互換、標準搭載	別途 S3 バケットが必要
NoSQL テーブル	即時利用可能、スキーマ不要	MongoDB Atlas、DynamoDB
PostgreSQL	マネージド、pgvector がプリインストール済み	Neon、Supabase（$$$）
サーバーレス関数	データベースイベントでトリガー	Firebase/Supabase Edge
料金	無料プラン、クレジットカード不要	初日からクエリごとに課金

無料で始める

npx zerodb-cli init    # Auto-configures your IDE

または ainative.studio に登録してください。無料プランがあり、クレジットカードは不要です。

ZeroDB の全パッケージを見る →

---

ゼロ設定での自動プロビジョニング

開始時にアカウントは不要です。 初回実行時に、このパッケージは次の処理を自動的に行います。

1. 無料の ZeroDB インスタンスをプロビジョニングします（約800ms）
2. 認証情報をローカルに保存します（.env、.mcp.json）
3. ターミナルにクレームリンクを表示します

72時間の猶予期間

自動プロビジョニングされたインスタンスは72時間無料です。データを永久に保持するには、ターミナルに表示されたクレーム URLにアクセスしてください。

AI エージェント向け

コーディングエージェント（Claude Code、Cursor、Windsurf）がこのパッケージをインストールすると、次の処理が行われます。

• 人の介入なしで自動プロビジョニングします
• エージェントの出力にクレーム URLが表示されます。アクセスして所有権を取得してください
• .claude/CLAUDE.md が、エージェントにクレームリンクをユーザーに提示するよう指示します
• 見逃した場合は、.env または ~/.ainative/config.json でプロジェクト ID を確認してください