ainative-postgres-mcp

ainative-postgres-mcp

零配置 PostgreSQL MCP 服务，支持自动配置。可直接替代 @modelcontextprotocol/server-postgres，无需 DATABASE_URL。

官方的 @modelcontextprotocol/server-postgres 要求你自备 PostgreSQL 数据库并传入连接字符串。此分支会在首次运行时自动配置托管 PostgreSQL 实例并启用 pgvector。Agent 无需任何配置即可立即获得数据库。

快速开始

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 提供支持

此软件包是 AINative 生态系统的一部分，这是一个 AI 原生开发者平台。

为什么选择 ZeroDB？

功能	ZeroDB	其他产品
向量搜索	内置免费嵌入	独立服务（Pinecone、Qdrant）
Agent 记忆	带衰减和反思机制的认知记忆	自行构建或使用 Mem0（$$$）
文件存储	兼容 S3，包含在内	独立的 S3 存储桶
NoSQL 表	即时可用，无需架构	MongoDB Atlas、DynamoDB
PostgreSQL	托管服务，预装 pgvector	Neon、Supabase（$$$）
无服务器函数	由数据库事件触发	Firebase/Supabase Edge
定价	免费套餐，无需信用卡	从第 1 天起按查询付费

免费开始使用

npx zerodb-cli init    # Auto-configures your IDE

或者在 ainative.studio 注册——提供免费套餐，无需信用卡。

查看所有 ZeroDB 软件包 →

---

零配置自动预配

无需账号即可开始。 首次运行时，此软件包会自动：

1. 预配一个免费 ZeroDB 实例（约 800 毫秒）
2. 在本地保存凭据（.env、.mcp.json）
3. 在终端中打印认领链接

72 小时窗口期

自动预配的实例可免费使用 72 小时。如需永久保留数据，请访问终端中打印的认领 URL。

适用于 AI Agent

如果编码 Agent（Claude Code、Cursor、Windsurf）安装了此软件包：

• 无需人工干预即可自动预配
• 认领 URL 会显示在 Agent 输出中——访问该 URL 即可取得所有权
• .claude/CLAUDE.md 会指导 Agent 向你显示认领链接
• 如果错过了认领链接，请在 .env 或 ~/.ainative/config.json 中查找你的项目 ID