pREST

pREST MCP 适配器

pREST HTTP MCP 端点的官方 stdio 适配器。

此适配器可让需要 stdio 的 MCP 客户端连接到正在运行且在 /_mcp 提供 HTTP MCP 端点的 pREST 实例。

MCP client / AI IDE
        ↓ stdio (NDJSON JSON-RPC)
prest-mcp
        ↓ HTTP POST
http://localhost:3000/_mcp
        ↓
pREST

该适配器是一个轻量传输桥接器。它不会检查架构、生成 SQL 或实现 MCP 工具。这些功能由 pREST 提供。

要求

• 正在运行且提供 /_mcp 路由的 pREST 实例
• Go 1.26+（从源代码构建时）

环境变量

变量	必需	默认值	描述
PREST_MCP_URL	是	—	pREST HTTP MCP 端点的 URL，例如 http://localhost:3000/_mcp
PREST_MCP_TOKEN	否	—	启用 pREST 身份验证时使用的 Bearer 令牌
PREST_MCP_TIMEOUT_MS	否	30000	HTTP 超时时间，单位为毫秒

安装

从源代码安装

go install github.com/prest/prest-mcp-adapter/cmd/prest-mcp@latest

Docker / OCI

docker pull ghcr.io/prest/prest-mcp-adapter:0.1.3

本地使用

PREST_MCP_URL=http://localhost:3000/_mcp prest-mcp

使用令牌

PREST_MCP_URL=https://api.example.com/_mcp \
PREST_MCP_TOKEN=secret \
prest-mcp

使用 Docker

docker run --rm -i \
  -e PREST_MCP_URL=http://host.docker.internal:3000/_mcp \
  ghcr.io/prest/prest-mcp-adapter:0.1.3

MCP 客户端配置

Cursor

添加到 MCP 设置中（例如 .cursor/mcp.json）：

{
  "mcpServers": {
    "prest": {
      "command": "prest-mcp",
      "env": {
        "PREST_MCP_URL": "http://localhost:3000/_mcp"
      }
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "prest": {
      "command": "prest-mcp",
      "env": {
        "PREST_MCP_URL": "http://localhost:3000/_mcp"
      }
    }
  }
}

通用 MCP 客户端

任何能够启动 stdio MCP 服务的客户端：

PREST_MCP_URL=http://localhost:3000/_mcp prest-mcp

协议消息是通过 stdin/stdout 传输、以换行符分隔的 JSON-RPC。日志仅写入 stderr。

安全建议

除非明确需要写入权限，否则请为 AI/MCP 工作流使用只读 PostgreSQL 用户。

请勿公开未经过身份验证的 MCP 端点。

优先使用本地或专用网络中的 pREST MCP 端点。

启用 pREST 身份验证时，请将 PREST_MCP_TOKEN 设置为有效的 JWT。

开发

make test       # go test -race ./... and overall coverage >= 80%
make coverage   # coverage gate only
make vet
make build      # writes bin/prest-mcp

许可证

MIT — 请参阅 LICENSE。