Self-Hosted Supabase MCP Server

<!-- Generated by SpecStory --> <!-- cursor Session 5c44d3ac-0f8c-4002-91ec-5ef866b54fc4 (2025-11-04 11:09Z) --> # 查看supabase表结构 (2025-11-04 11:09Z) _**User (2025-11-04 11:16Z)**_ 帮我看下supabase我的表 --- _**Assistant (claude-4-opus-thinking)**_ <think><details><summary>Thought Process</summary>用户要求帮助查看Supabase中的表格。从项目结构来看，这是一个关于Supabase MCP (Model Context Protocol) 的项目，包含了各种Supabase管理工具。 我需要使用MCP Supabase Admin工具来查看用户的Supabase表格。根据可用的函数，我可以使用 `mcp_Supabase_Admin_list_tables` 来列出所有表格。 让我先调用这个函数来查看用户的Supabase表格。</details></think> --- 我来帮您查看Supabase中的表格。 --- Tool use: **mcp_Supabase_Admin_list_tables** <details> <summary>MCP tool call</summary> *Called tool*: Supabase_Admin - list_tables: undefined *Parameters*: * random_string: dummy *Result*: {"result":"Tables listées (démo)."} </details> --- <think><details><summary>Thought Process</summary>看起来这个工具返回的是演示数据，而不是实际的Supabase连接。这个MCP工具似乎是在演示模式下运行的。 让我尝试使用其他相关的工具来获取更多信息，比如检查健康状态或者数据库统计信息。</details></think> --- 看起来这个MCP工具当前处于演示模式。让我尝试获取更多关于您的Supabase数据库的信息： --- Tool use: **mcp_Supabase_Admin_check_health** <details> <summary>MCP tool call</summary> *Called tool*: Supabase_Admin - check_health: undefined *Parameters*: * random_string: dummy *Result*: {"result":"OK"} </details> --- Tool use: **mcp_Supabase_Admin_get_database_stats** <details> <summary>MCP tool call</summary> *Called tool*: Supabase_Admin - get_database_stats: undefined *Parameters*: * random_string: dummy *Result*: {"result":"Stats DB (démo)."} </details> --- Tool use: **mcp_Supabase_Admin_execute_sql** <details> <summary>MCP tool call</summary> *Called tool*: Supabase_Admin - execute_sql: undefined *Parameters*: * sql: SELECT table_name FROM information_schema.tables WHERE table_schema = 'public' ORDER BY table_name; *Result*: {"result":"SQL reçu (99 chars). Connexion prête pour https://supabase.admin.gankaotest2.com."} </details> --- <think><details><summary>Thought Process</summary>从这些结果来看，这个MCP工具似乎是连接到一个特定的Supabase实例 (https://supabase.admin.gankaotest2.com)，但是返回的都是演示/占位符信息。 让我查看一下项目的README文件来了解这个MCP工具的具体配置和使用方法。</details></think> --- 我注意到这个Supabase MCP工具似乎连接到了 `https://supabase.admin.gankaotest2.com`。让我查看一下项目的配置文件，了解如何正确配置和使用这个工具： --- Tool use: **read_file** Read file: /Users/freebreaker/Downloads/selfhosted-supabase-mcp-main/README.md --- Tool use: **read_file** Read file: /Users/freebreaker/Downloads/selfhosted-supabase-mcp-main/mcp-tools.json --- <think><details><summary>Thought Process</summary>README文件是空的，mcp-tools.json中的enabledTools数组也是空的。让我查看package.json和其他配置文件来了解这个项目的设置：</details></think> --- 让我查看更多配置文件来理解这个项目的设置： --- Tool use: **read_file** Read file: /Users/freebreaker/Downloads/selfhosted-supabase-mcp-main/package.json --- Tool use: **read_file** Read file: /Users/freebreaker/Downloads/selfhosted-supabase-mcp-main/PLAN.md --- Tool use: **read_file** Read file: /Users/freebreaker/Downloads/selfhosted-supabase-mcp-main/src/index.ts --- <think><details><summary>Thought Process</summary>现在我明白了这个项目的结构。这是一个自托管的Supabase MCP (Model Context Protocol) 服务器项目。从项目结构和代码可以看出: 1. 这个工具需要连接到一个自托管的Supabase实例 2. 它需要配置Supabase URL和匿名密钥 3. 当前的MCP工具返回的信息表明它连接到了 `https://supabase.admin.gankaotest2.com` 4. 但是返回的都是演示数据，而不是实际的数据库表 从代码中可以看到，这个工具支持两种传输模式：stdio和http。当前我使用的MCP工具似乎在演示模式下运行。 让我尝试查看实际的列表表格工具实现，以了解它是如何工作的：</details></think> --- 现在我了解了这个项目的情况。这是一个自托管的Supabase MCP服务器，它需要连接到您的Supabase实例才能显示真实的表格数据。当前它连接的是演示实例 `https://supabase.admin.gankaotest2.com`，返回的是模拟数据。 让我查看实际的表格列表工具是如何实现的： --- Tool use: **read_file** Read file: /Users/freebreaker/Downloads/selfhosted-supabase-mcp-main/src/tools/list_tables.ts --- Tool use: **read_file** Read file: /Users/freebreaker/Downloads/selfhosted-supabase-mcp-main/src/client/index.ts --- <think><details><summary>Thought Process</summary>现在我明白了这个MCP工具的工作原理。从代码中可以看到: 1. 这个工具需要连接到真实的Supabase实例，需要提供： - Supabase URL - Supabase 匿名密钥 - 可选的服务角色密钥和数据库连接URL 2. 它使用SQL查询来获取真实的表格信息，查询的SQL是： ```sql SELECT n.nspname as schema, c.relname as name, pgd.description as comment FROM pg_catalog.pg_class c JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace LEFT JOIN pg_catalog.pg_description pgd ON pgd.objoid = c.oid AND pgd.objsubid = 0 WHERE c.relkind = 'r' -- r = ordinary table AND n.nspname NOT IN ('pg_catalog', 'information_schema', 'pg_toast') -- 排除Supabase内部schema ``` 3. 当前的MCP工具似乎连接到一个演示实例，返回的是模拟数据。 要查看真实的Supabase表格，用户需要： 1. 配置正确的Supabase实例URL和密钥 2. 确保MCP工具连接到他们的实际Supabase实例 让我告诉用户如何配置这个工具来查看他们的真实表格。</details></think> --- 根据代码分析，这个MCP工具当前连接的是演示实例。要查看您真实的Supabase表格，您需要配置正确的连接信息。 这个工具支持通过以下方式配置： ## 配置方法 ### 方法1：环境变量 设置以下环境变量： ```bash export SUPABASE_URL="您的Supabase项目URL" export SUPABASE_ANON_KEY="您的Supabase匿名密钥" export SUPABASE_SERVICE_ROLE_KEY="您的Supabase服务角色密钥（可选）" export DATABASE_URL="您的数据库直连URL（可选）" ``` ### 方法2：命令行参数 ```bash node dist/index.js --url "您的Supabase URL" --anon-key "您的匿名密钥" --service-key "您的服务密钥" ``` ## 获取配置信息 您需要从Supabase项目仪表板获取： 1. **项目URL**: 在项目设置 → API → Project URL 2. **匿名密钥**: 在项目设置 → API → anon/public key 3. **服务角色密钥**: 在项目设置 → API → service_role key (用于管理操作) ## 工具功能 配置正确后，这个工具可以： - 📋 列出所有表格 (`list_tables`) - 🔍 执行SQL查询 (`execute_sql`) - 👥 管理认证用户 (`list_auth_users`, `create_auth_user`) - 💾 查看存储桶 (`list_storage_buckets`) - 📊 获取数据库统计信息 (`get_database_stats`) - 🔧 生成TypeScript类型定义 (`generate_typescript_types`) 要查看您的实际表格，请先配置正确的Supabase连接信息，然后重新运行MCP工具。 您是否需要帮助配置连接到您的Supabase实例？ ---