Supabase MCP Server

基本能力

产品定位

SB-MCP是一个数据库操作中间件，专门为大型语言模型(如Claude)与Supabase数据库的交互提供桥梁。

核心功能

• 数据库操作:
• 带过滤器的数据查询
• 数据插入
• 数据更新
• 数据删除
• 表列表查询

适用场景

• 需要将LLMs与Supabase数据库集成的应用
• 自动化数据库操作的工作流
• 基于自然语言的数据库查询系统

工具列表

1. queryDatabase: 查询数据库表数据
2. insertData: 向表中插入数据
3. updateData: 更新表中的数据
4. deleteData: 删除表中的数据
5. listTables: 列出所有可用表

常见问题解答

1. 端口被占用: 修改.env文件中的MCP_SERVER_PORT值
2. 缺少环境变量: 确保.env文件配置完整
3. 类型错误: 更新到最新版本
4. Claude JSON解析错误: 使用Claude专用二进制
5. Claude请求超时: 检查Supabase凭证和服务器状态

使用教程

使用依赖

• Node.js (v16或更新版本)
• npm或yarn
• 具有API密钥的Supabase项目

安装教程

选项1: 从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

配置

创建.env文件:

SUPABASE_URL=your_supabase_project_url
SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
MCP_SERVER_PORT=3000
MCP_SERVER_HOST=localhost
MCP_API_KEY=your_secret_api_key

调试方式

与Claude集成测试

npm run start:claude

或

supabase-mcp-claude

独立服务器测试

supabase-mcp

代码集成测试

import { createServer, mcpConfig, validateConfig } from 'supabase-mcp';

validateConfig();
const app = createServer();
app.listen(mcpConfig.port, mcpConfig.host, () => {
  console.log(`Server running at http://${mcpConfig.host}:${mcpConfig.port}`);
});

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。