Supabase MCP 服务器

一个模型上下文协议（MCP）服务器，允许Claude和其他大型语言模型与Supabase交互，执行Postgres表的 CRUD 操作。

功能

• 数据库操作：
  • 使用过滤器查询数据
  • 插入数据
  • 更新数据
  • 删除数据
  • 列出表格

先决条件

• Node.js（v16或更高版本）
• npm 或 yarn
• 带有API密钥的Supabase项目

安装

选项 1：通过npm安装（推荐）

该包已发布到npm！你可以全局安装：

npm install -g supabase-mcp

或者在你的项目中本地安装：

npm install supabase-mcp

选项 2：克隆仓库

git clone https://github.com/Cappahccino/SB-MCP.git
cd SB-MCP
npm install
npm run build

配置

创建一个名为 mcp.json 的文件并添加以下内容到你的项目根目录：

{
  "supabase": {
    "url": "YOUR_SUPABASE_URL",
    "anonKey": "YOUR_SUPABASE_ANON_KEY"
  }
}

将 YOUR_SUPABASE_URL 和 YOUR_SUPABASE_ANON_KEY 替换为你的实际Supabase项目URL和匿名密钥。

使用

作为独立服务器

运行以下命令启动MCP服务器：

node index.js

集成到其他项目中

在你的项目中引入并使用：

const { MCP } = require('supabase-mcp');
const mcp = new MCP();

// 查询数据
mcp.query('your-supabase-project-id', {
  query: {
    table: 'users',
    where: {
      id: 1
    }
  },
  response: {
    format: 'json'
  }
}).then(console.log);

// 插入数据
mcp.execute('your-supabase-project-id', {
  command: 'insert',
  data: { name: 'Alice' },
  query: {
    table: 'users'
  }
});

故障排除

常见问题及解决方案

• 问题：无法连接到Supabase

  • 确保你已经在 mcp.json 中正确配置了你的项目URL和密钥。

• 问题：查询返回空结果

  • 检查过滤器是否正确，并确保表名存在。

工具参考

数据库操作命令

查询数据

{
  "command": "query",
  "project_id": "your-supabase-project-id",
  "data": {
    "table": "users",
    "where": { "id": 1 }
  },
  "response": { "format": "json" }
}

插入数据

{
  "command": "insert",
  "project_id": "your-supabase-project-id", 
  "data": {
    "table": "users",
    "values": { name: 'Alice' }
  }
}

版本历史

• 1.0.0：初始发布
• 1.0.1：添加了自动端口选择
• 1.0.2：修复了协议兼容性问题
• 1.0.3：添加了JSON-RPC支持
• 1.1.0：完全重写为官方MCP SDK
• 1.2.0：新增独立的Claude传输并修复端口冲突问题
• 1.3.0：更新以提高与TypeScript项目的兼容性
• 1.4.0：根据Supabase社区最佳实践修复了Claude标准输入输出集成
• 1.5.0：移除Edge Function支持，专注于数据库操作稳定性

许可证

MIT