PostgREST

@supabase/mcp-server-postgrest

这是PostgREST的 MCP 服务器。它允许 LLM 通过 REST API 在你的应用上执行 CRUD 操作。

该服务器可与 Supabase 项目（运行 PostgREST）和任何独立的 PostgREST 服务器配合使用。

工具

可以使用以下工具：

postgrestRequest

向已配置的PostgREST 服务器执行 HTTP 请求。它接受以下参数：

• method ：要使用的 HTTP 方法（例如GET 、 POST 、 PATCH 、 DELETE ）
• path ：查询的路径（例如/todos?id=eq.1 ）
• body ：请求主体（用于POST和PATCH请求）

它返回来自 PostgREST 服务器的 JSON 响应，包括GET请求的选定行以及POST和PATCH请求的更新行。

sqlToRest

将 SQL 查询转换为等效的 PostgREST 语法（作为方法和路径）。这对于 LLM 难以转换为有效 PostgREST 语法的复杂查询非常有用。

请注意，PostgREST 仅支持 SQL 的子集，因此并非所有查询都会转换。有关更多详细信息，请参阅sql-to-rest 。

它接受以下参数：

• sql ：要转换的 SQL 查询。

它返回一个包含请求的method和path属性的对象。然后，LLM 可以使用postgrestRequest工具来执行该请求。

用法

使用 Claude Desktop

Claude Desktop是一款流行的 LLM 客户端，支持模型上下文协议 (MCP)。您可以将 PostgREST 服务器连接到 Claude Desktop，以便通过自然语言命令查询数据库。

您可以通过以下配置文件将 MCP 服务器添加到 Claude Desktop：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

要将您的 Supabase 项目*（或任何 PostgREST 服务器）*添加到 Claude Desktop，请将以下配置添加到配置文件中的mcpServers对象：

配置

• apiUrl ：PostgREST 端点的基本 URL
• apiKey ：用于身份验证的 API 密钥*（可选）*
• schema ：用于提供 API 的 Postgres 模式（例如public ）。请注意，任何非公共模式都必须从 PostgREST 手动公开。

以编程方式（自定义 MCP 客户端）

如果您正在构建自己的 MCP 客户端，可以使用您首选的传输方式以编程方式连接到 PostgREST 服务器。MCP SDK提供内置的stdio和SSE传输方式。如果您希望直接连接到内存中的 MCP 服务器，或者通过您自己的基于流的传输方式进行管道传输，我们还提供StreamTransport接口。

安装

例子

以下示例使用StreamTransport直接连接 MCP 客户端和服务器。