alexander-zuev/supabase-mcp-server

数据库管理

本页由 AI 翻译，技术细节请以原文为准。查看原文

835 stars 103 forks 质量 91 趋势 30Apache-2.0

Repository Install

查询MCP通过聊天界面实现Supabase的端到端管理：读写查询执行、管理API支持、自动迁移版本管理、日志访问等功能。

概览

🌅 通过 pypi 安装超过 1.7 万次，Smithery.ai 下载量接近 3 万次——总之，这真是很有趣！🥳感谢过去几个月所有使用这个服务器的朋友，希望对你们有所帮助。自从 Supabase 发布了官方 MCP 服务器后，我决定不再积极维护这个服务器。官方 MCP 服务器功能丰富，未来还会添加更多功能。快去看看吧！ Query MCP 是一个开源的 MCP 服务器，允许你的 IDE 安全地运行 SQL、管理模式变更、调用 Supabase 管理 API，并使用 Auth Admin SDK——所有这些都内置了安全控制。

概述（AI 翻译）

🌅 通过 pypi 安装超过 1.7 万次，Smithery.ai 下载量接近 3 万——简而言之，这非常有趣！🥳 感谢过去几个月一直使用这个服务器的每一位朋友，希望对你们有所帮助。自 Supabase 发布了自己的官方 MCP 服务器，我决定不再积极维护这个服务器。官方MCP服务器功能同样丰富，还有更多功能。功能未来会添加。快去看看吧！

Query MCP 是一个开源的 MCP 服务器，允许你的 IDE 安全地运行 SQL、管理模式变更、调用 Supabase 管理 API，并使用 Auth Admin SDK——所有这些都内置了安全控制。

✨ 主要特征

💻 兼容光标、Windsurf、Cline及其他支持stdio协议的MCP客户端
🔐 控制SQL查询的只读和读写模式
🔍 运行时SQL查询验证及风险级别评估
🛡️ SQL操作的三层安全系统：安全、写入和破坏性
🔄 对直接和池数据库连接都支持稳健的事务处理

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

Query | MCP server for Supabase

🌅 More than 17k installs via pypi and close to 30k downloads on Smithery.ai — in short, this was fun! 🥳 Thanks to everyone who has been using this server for the past few months, and I hope it was useful for you. Since Supabase has released their own official MCP server, I’ve decided to no longer actively maintain this one. The official MCP server is as feature-rich, and many more features will be added in the future. Check it out!

Query MCP is an open-source MCP server that lets your IDE safely run SQL, manage schema changes, call the Supabase Management API, and use Auth Admin SDK — all with built-in safety controls.

Getting started • Feature overview • Troubleshooting • Changelog

✨ Key features

💻 Compatible with Cursor, Windsurf, Cline and other MCP clients supporting stdio protocol
🔐 Control read-only and read-write modes of SQL query execution
🔍 Runtime SQL query validation with risk level assessment
🛡️ Three-tier safety system for SQL operations: safe, write, and destructive
🔄 Robust transaction handling for both direct and pooled database connections
📝 Automatic versioning of database schema changes
💻 Manage your Supabase projects with Supabase Management API

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
    "mcpServers": {
      "supabase": {
        "command": "/Users/username/.local/bin/supabase-mcp-server",  // update path
        "env": {
          "QUERY_API_KEY": "your-api-key",  // Required - get your API key at thequery.dev
          "SUPABASE_PROJECT_REF": "your-project-ref",
          "SUPABASE_DB_PASSWORD": "your-db-password",
          "SUPABASE_REGION": "us-east-1",  // optional, defaults to us-east-1
          "SUPABASE_ACCESS_TOKEN": "your-access-token",  // optional, for management API
          "SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"  // optional, for Auth Admin SDK
        }
      }
    }
}