mcp

Prisma MCP 是基于 Model-Context-Protocol (MCP) 的服务器实现，旨在让 LLM 能够调用 API 并以定义良好的方式访问外部系统。Prisma 提供了两个 MCP 服务器：本地和远程。

用途

• 本地 MCP 服务器：适用于在本地机器上工作的开发者，希望 AI 代理帮助处理数据库工作流。
• 远程 MCP 服务器：适用于构建“AI 平台”并希望让用户能够管理数据库的开发者。

主要能力

远程 MCP 服务器暴露以下工具：

• CreateBackupTool：创建新的托管 Prisma Postgres 备份。
• CreateConnectionStringTool：为给定 ID 的 Prisma Postgres 数据库创建新的连接字符串。
• CreateRecoveryTool：使用给定备份 ID 将 Prisma Postgres 数据库恢复到新数据库。
• DeleteConnectionStringTool：删除给定连接字符串 ID 的连接字符串。
• DeleteDatabaseTool：删除给定 ID 的 Prisma Postgres 数据库。
• ListBackupsTool：获取给定数据库 ID 和环境 ID 的可用 Prisma Postgres 备份列表。
• ListConnectionStringsTool：获取给定数据库 ID 和环境 ID 的可用 Prisma Postgres 数据库连接字符串列表。
• ListDatabasesTool：获取用户工作区中可用的 Prisma Postgres 数据库列表。
• ExecuteSqlQueryTool：在给定 ID 的 Prisma Postgres 数据库上执行 SQL 查询。
• IntrospectSchemaTool：内省给定 ID 的 Prisma Postgres 数据库的模式。

连接远程 MCP 服务器后，可以提示 AI 代理“列出 Prisma 工具”以获取最新支持工具的完整概览。

本地 MCP 服务器暴露以下工具：

• migrate-status：通过 prisma migrate status 命令检查迁移状态。
• migrate-dev：通过 prisma migrate dev --name <name> 命令创建并执行迁移，LLM 提供 <name> 选项。
• migrate-reset：通过 prisma migrate reset --force 命令重置数据库。
• Prisma-Postgres-account-status：通过 platform auth show --early-access 命令检查与 Prisma Console 的认证状态。
• Create-Prisma-Postgres-Database：通过 'init --db --name' <name> '--region' <region> '--non-interactive' 命令创建新的 Prisma Postgres 数据库，LLM 提供 <name> 和 <region> 选项。
• Prisma-Login：通过 platform auth login --early-access 命令与 Prisma Console 进行认证。
• Prisma-Studio：通过 prisma studio 命令打开 Prisma Studio。

使用方式

远程 MCP 服务器遵循标准的 JSON 配置：

{
  "mcpServers": {
    "Prisma-Remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.prisma.io/mcp"]
    }
  }
}

本地 MCP 服务器遵循标准的 JSON 配置：

{
  "mcpServers": {
    "Prisma-Local": {
      "command": "npx",
      "args": ["-y", "prisma", "mcp"]
    }
  }
}

在 AI 工具中集成：

• VS Code：在 .vscode/mcp.json 文件中添加配置。VS Code 代理模式可直接在聊天中输入“create Postgres database”或“apply schema migration”，自动处理底层 Prisma CLI 调用和 API 调用。
• Cursor：可通过一键安装链接或手动在 Cursor 设置中添加。全局配置修改 ~/.cursor/mcp.json；项目级配置在项目根目录的 .cursor 目录中。
• Windsurf：推荐通过 Windsurf MCP 插件商店添加 Prisma MCP 插件。也可在设置中选择 Cascade，点击 Add Server，添加 Prisma-Local 和/或 Prisma-Remote 片段，修改全局 ~/.codeium/windsurf/mcp_config.json。
• Warp：在 MCP 设置中点击 + Add，以 JSON 配置 Prisma MCP 服务器，使用 command 和 args 属性启动，可选配置 start_on_launch 标志使其在启动时激活。保存后确保服务器运行，新终端中即可让 Warp 管理 Prisma 数据库。
• Claude Code：使用 claude mcp add 命令添加本地或远程 MCP 服务器。
• Claude Desktop：根据文档创建配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %APPDATA%\Claude\claude_desktop_config.json），添加 JSON 片段。
• OpenAI Agents SDK：提供了在 Python 脚本中使用 Prisma MCP 服务器的示例。

远程 MCP 服务器可通过 Cloudflare 的 AI Playground 试用：在文本框中输入 https://mcp.prisma.io/mcp，点击 Connect，在弹出的窗口中通过 Prisma Console 认证。连接后，可以发送提示并查看 LLM 基于提示选择的 MCP 工具。

示例提示

远程服务器示例：

• "Show me a list of all the databases in my account."
• "Create a new database in the US region for me."
• "Seed my database with real-looking data but create a backup beforehand."
• "Show me all available backups of my database."
• "Show me all customers and run an analysis over their orders."

本地服务器示例：

• "Log me into the Prisma Console."
• "Create a database in the US region."
• "Create a new Product table in my database."

适用场景

• 开发者使用本地 AI 代理辅助数据库迁移、状态检查、创建数据库等。
• AI 平台构建者通过远程 MCP 服务器让用户管理数据库。
• 在支持的 AI 工具（如 VS Code、Cursor、Windsurf、Warp、Claude Code、Claude Desktop 等）中集成 Prisma MCP，实现自然语言数据库操作。

限制

• 远程 MCP 服务器需要 Prisma Console 认证。
• 本地 MCP 服务器需要本地环境支持 npx 和 Prisma CLI。
• 该仓库还提到了 MCP Review 认证、行为准则和安全政策，但具体内容暂未提供。