如何为Cursor配置连接Supabase的MCP服务器并排查调用无返回问题？

一、配置文件位置说明 #

• 全局配置/Users/<username>/Library/Application Support/Cursor/mcp.json：作用于所有Cursor打开的项目，适合通用MCP服务配置。
• 项目目录.cursor/mcp.json：仅对当前项目生效，优先级高于全局配置，推荐用于项目专属数据库连接配置，你当前使用的项目目录配置逻辑是合理的。

二、依赖安装建议 #

• 不需要强制全局安装@modelcontextprotocol/server-postgres，你配置里的npx -y会自动临时安装并运行依赖，这个写法是有效的。如果后续频繁使用，可全局安装以加快启动速度：

  npm install -g @modelcontextprotocol/server-postgres
  

  安装后可将配置中的npx -y替换为直接写包名，比如@modelcontextprotocol/server-postgres。

三、Supabase专属MCP服务选择 #

@supabase/mcp-server-postgrest是Supabase官方推出的MCP服务，相比通用的server-postgres，它针对Supabase的Postgrest API做了适配，能更好支持Supabase特性（如行级安全、实时数据等）。若连接的是Supabase云端数据库，建议替换为这个官方包，配置示例如下：

"development": {
  "type": "stdio",
  "command": "npx",
  "args": [
    "-y",
    "@supabase/mcp-server-postgrest",
    "https://[YOUR_PROJECT_REF].supabase.co",
    "[YOUR_ANON_KEY]"
  ],
  "env": {
    "DEBUG": "*"
  }
}

注意此处使用的是Supabase的API地址和匿名密钥，而非直接的PostgreSQL连接串。

四、服务器显示绿色但无返回结果的排查步骤 #

1. 验证数据库连接串有效性
   直接用psql命令测试Supabase连接串是否能正常访问：

   psql postgresql://postgres.[YOUR_PROJECT_REF]:[YOUR_DB_PASSWORD]@db.[YOUR_PROJECT_REF].supabase.co:5432/postgres
   

   若连接失败，检查密码、项目REF是否正确，同时确认Supabase控制台的数据库允许你的IP访问（路径：Supabase控制台→数据库→连接池→允许的IP地址）。

2. 查看MCP服务日志
   你已配置DEBUG: "*"，可在Cursor的MCP服务日志中查看详细错误信息：

   • 打开Cursor设置→MCP→找到对应服务，点击"查看日志"
     日志会显示连接过程中的具体错误，比如权限不足、表不存在、SQL语法问题等。

3. 检查Cursor工具调用逻辑
   确保在Cursor中调用工具时，正确关联到目标MCP服务（如使用#query指令时指定local/development/production服务器，或默认服务配置正确）。

4. 权限验证
   确认Supabase数据库的postgres用户有足够权限访问你要查询的表，可切换到Supabase的anon用户（搭配行级安全）进行测试，避免因权限不足导致无返回结果。

内容的提问来源于stack exchange，提问作者Rolando Niubó