Provides tools for direct PostgreSQL database operations, including executing SQL queries, viewing database connections and statistics, listing extensions, and querying system catalogs.
Enables interaction with self-hosted Supabase instances, providing tools for database introspection, SQL query execution, schema management, migrations, auth user management, storage bucket operations, and TypeScript type generation.
该项目提供了一个专为与自托管 Supabase 实例交互而设计的模型上下文协议 (MCP)服务器。它弥合了 MCP 客户端（如 IDE 扩展）与您本地或私有托管的 Supabase 项目之间的差距，使您能够直接从开发环境进行数据库自省、管理和交互。
该服务器是从头开始构建的，借鉴了官方 Supabase 云 MCP 服务器的经验教训，以提供针对自托管用例量身定制的最小、集中的实现。
该服务器的主要目标是使使用自托管 Supabase 安装的开发人员能够利用基于 MCP 的工具执行以下任务：
它避免了与多项目管理和特定于云的 API 相关的官方云服务器的复杂性，为单项目、自托管环境提供了简化的体验。
服务器向 MCP 客户端公开以下工具：
list_tables ：列出数据库模式中的表。list_extensions ：列出已安装的 PostgreSQL 扩展。list_migrations ：列出已应用的 Supabase 迁移。apply_migration ：应用 SQL 迁移脚本。execute_sql ：执行任意 SQL 查询（通过 RPC 或直接连接）。get_database_connections ：显示活动数据库连接（ pg_stat_activity ）。get_database_stats ：检索数据库统计信息（ pg_stat_* ）。get_project_url ：返回配置的 Supabase URL。get_anon_key ：返回配置的 Supabase 匿名密钥。get_service_key ：返回配置的 Supabase 服务角色密钥（如果提供）。verify_jwt_secret ：检查 JWT 机密是否已配置并返回预览。generate_typescript_types ：从数据库模式生成 TypeScript 类型。rebuild_hooks ：尝试重新启动pg_net工作程序（如果使用）。list_auth_users ：列出来自auth.users的用户。get_auth_user ：检索特定用户的详细信息。create_auth_user ：创建新用户（需要直接数据库访问，不安全的密码处理）。delete_auth_user ：删除用户（需要直接数据库访问）。update_auth_user ：更新用户详细信息（需要直接数据库访问，不安全的密码处理）。list_storage_buckets ：列出所有存储桶。list_storage_objects ：列出特定存储桶内的对象。list_realtime_publications ：列出 PostgreSQL 出版物（通常是supabase_realtime ）。（注意：最初计划使用get_logs ，但由于自托管环境中的实现复杂性而被跳过）。
要通过Smithery自动为 Claude Desktop 安装自托管 Supabase MCP 服务器：
dist目录中的 TypeScript 代码编译为 JavaScript。服务器需要您 Supabase 实例的配置详细信息。您可以通过命令行参数或环境变量提供这些配置信息。CLI 参数优先。
必需的：
--url <url>或SUPABASE_URL=<url> ：Supabase 项目的主 HTTP URL（例如， http://localhost:8000 ）。--anon-key <key>或SUPABASE_ANON_KEY=<key> ：您的 Supabase 项目的匿名密钥。可选（但对于某些工具来说是推荐/必需的）：
--service-key <key>或SUPABASE_SERVICE_ROLE_KEY=<key> ：你的 Supabase 项目的服务角色密钥。用于需要提升权限的操作，例如尝试在不存在的情况下自动创建execute_sql辅助函数。--db-url <url>或DATABASE_URL=<url> ：Supabase 数据库的直接 PostgreSQL 连接字符串（例如， postgresql://postgres:password@localhost:5432/postgres ）。对于需要直接访问数据库或进行事务处理的工具（ apply_migration 、身份验证工具、存储工具、查询pg_catalog等）是必需的。--jwt-secret <secret>或SUPABASE_AUTH_JWT_SECRET=<secret> ：你的 Supabase 项目的 JWT 密钥。verify_jwt_secret verify_jwt_secret工具需要用到。--tools-config <path> ：指定要启用哪些工具（白名单）的 JSON 文件路径。如果省略，则启用服务器中定义的所有工具。该文件的格式应为{"enabledTools": ["tool_name_1", "tool_name_2"]} 。execute_sql辅助函数：*许多工具依赖于 Supabase 数据库中的public.execute_sql函数，以便通过 RPC 安全高效地执行 SQL。服务器会在启动时尝试检查此函数。如果缺少此函数，并且*提供了service-key （或SUPABASE_SERVICE_ROLE_KEY ）和db-url （或DATABASE_URL ），它将尝试创建该函数并授予必要的权限。如果创建失败或未提供密钥，则仅依赖 RPC 的工具可能会失败。auth 、 storage ）或系统目录（ pg_catalog ）交互的工具通常需要配置DATABASE_URL以进行直接pg连接。使用 Node.js 运行服务器，提供必要的配置：
该服务器通过标准输入/输出 (stdio) 进行通信，旨在由 MCP 客户端应用程序（例如 Cursor 之类的 IDE 扩展）调用。客户端将连接到服务器的 stdio 流，以列出并调用可用的工具。
以下是如何配置流行的 MCP 客户端以使用此自托管服务器的示例。
重要的：
<your-supabase-url> 、 <your-anon-key> 、 <your-db-url> 、 <path-to-dist/index.js>等占位符。dist/index.js ）的路径对于您的系统来说是正确的。.cursor/mcp.json 。VS Code Copilot 允许使用通过提示输入填充的环境变量，这对于密钥来说更安全。
.vscode/mcp.json 。调整 Cursor 或官方 Supabase 文档所示的配置结构，用node命令和此服务器的args替换command和参数，类似于 Cursor 示例：
查阅每个客户端的具体文档，了解mcp.json或等效配置文件的放置位置。
tsc （TypeScript 编译器）npm管理（ package.json ）@supabase/supabase-js 、 pg （node-postgres）、 zod （验证）、 commander （CLI 参数）、 @modelcontextprotocol/sdk （MCP 服务器框架）。本项目遵循 MIT 许可证。详情请参阅许可证文件。
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
一种协议服务器，可直接从开发环境与自托管的 Supabase 实例进行交互，允许通过 IDE 扩展等 MCP 客户端进行数据库自省、迁移管理、用户身份验证和存储。