Supabase MCP Server

Name: Supabase MCP Server
Author: Cappahccino

@Cappahccino

リポジトリ

Supabase MCP Server について

Supabase Model Context Protocol (MCP) server for CRUD operations and Edge Functions

基本情報

カテゴリ

クラウドとインフラ

ライセンス

MIT license

ランタイム

node

トランスポート

stdio

公開者

Cappahccino

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": [
        "-y",
        "supabase-mcp@latest",
        "supabase-mcp-claude"
      ],
      "env": {
        "SUPABASE_URL": "",
        "SUPABASE_ANON_KEY": "",
        "SUPABASE_SERVICE_ROLE_KEY": "",
        "MCP_API_KEY": ""
      }
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Supabase MCP Server?

It is a Model Context Protocol (MCP) server that lets Claude and other large language models perform CRUD operations—query, insert, update, delete, and list tables—on Postgres tables in a Supabase project.

How to use Supabase MCP Server?

Install globally or locally via npm, then configure Supabase credentials and an API key. For Claude Desktop, use the dedicated supabase-mcp-claude binary with stdio transport. For standalone use, run the HTTP server at a configurable port. It can also be imported as a library in Node.js projects.

Key features of Supabase MCP Server

Query data with filters
Insert data into tables
Update existing records
Delete records by conditions
List all tables in the database
Supports both stdio (Claude) and HTTP transports

Use cases of Supabase MCP Server

Give Claude direct read/write access to a Supabase database via natural language
Automate database tasks such as bulk inserts or conditional updates
Enable AI-driven data exploration and reporting on Supabase projects

FAQ from Supabase MCP Server

What are the prerequisites?

Node.js v16 or newer, npm or yarn, and a Supabase project with your API keys (URL, anon key, and service role key).

How do I fix "Port XXXX is already in use"?

The server automatically tries to find an available port. You can manually set a different port in your .env file by changing MCP_SERVER_PORT.

Why do I get "Missing required environment variables"?

Ensure you have a valid .env file with SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, and MCP_API_KEY, or set those variables in your system environment.

What transport should I use for Claude?

Use the Claude-specific binary (supabase-mcp-claude) with the stdio transport. The regular HTTP server (supabase-mcp) is for standalone use and is not compatible with Claude Desktop.

How do I resolve "Request timed out with Claude"?

Check that your Supabase credentials are correct, the server is running, and no network issues are blocking the connection. Also ensure you are using the Claude binary, not the HTTP server.